WhatsApp y SMS
WhatsApp y SMS se integran via Twilio para comunicacion movil con candidatos.
Modelo de Sesiones
WHATSAPP BUSINESS API - VENTANA DE 24 HORAS
| Estado | Opciones |
|---|---|
| SIN SESION | Solo templates, HSM aprobados, inicia sesion |
| CON SESION | Mensajes libres, sin restriccion, hasta que expire |
Flujo:
- Candidato responde
- SESION ACTIVA (24h)
- Mensajes ilimitados
- 24h sin respuesta -> Sesion expira
Verificar Estado de Sesion
Con sesion activa:
| Campo | Valor |
|---|---|
| Estado | Sesion activa |
| Expira en | 18 horas |
| Mensajes restantes | 985/1000 |
Sin sesion activa:
| Campo | Valor |
|---|---|
| Estado | Sin sesion activa |
| Accion | Usa un template para iniciar |
| Boton | [Enviar Template] |
Templates (HSM)
Templates pre-aprobados por WhatsApp:
BIENVENIDA:
"Hola {{1}}! Gracias por aplicar a {{2}}. Te contactamos para darte seguimiento."
RECORDATORIO_ENTREVISTA:
"Hola {{1}}, te recordamos tu entrevista para {{2}} manana a las {{3}}. Confirmas asistencia?"
SOLICITUD_DOCUMENTOS:
"Hola {{1}}, necesitamos los siguientes documentos para continuar: {{2}}. Puedes enviarlos?"
RESULTADO_PROCESO:
"Hola {{1}}, tenemos noticias sobre tu proceso en {{2}}. Podemos llamarte?"
Enviar Template
- Selecciona hilo
- Click en WhatsApp
- Si no hay sesion: Aparece selector de template
Modal de Template:
| Campo | Valor |
|---|---|
| Template | [Bienvenida] |
| Variable {{1}} | Juan |
| Variable {{2}} | Desarrollador Senior |
Vista previa:
"Hola Juan! Gracias por aplicar a Desarrollador Senior. Te contactamos para darte seguimiento."
[Cancelar] [Enviar Template]
Formato de Numero Mexico
WhatsApp Mexico requiere formato especial:
| Tipo | Formato |
|---|---|
| Numero local | 55 1234 5678 |
| Formato normal | +52 55 1234 5678 |
| Formato WhatsApp | +521 55 1234 5678 (nota el "1" extra) |
El sistema convierte automaticamente numeros de Mexico al formato correcto.
Mensajes en Sesion
Con sesion activa, envia mensajes libremente:
- Selecciona hilo
- Click en WhatsApp
- Escribe mensaje
- Click [Enviar]
El mensaje va directamente sin template.
SMS
Caracteristicas
SMS VIA TWILIO:
Limitaciones:
- Solo texto (sin multimedia)
- 160 caracteres = 1 segmento (GSM-7)
- 70 caracteres = 1 segmento (Unicode)
- Emojis = Unicode = menos caracteres
- Mensajes largos = multiples segmentos
Calculador de Segmentos
El sistema calcula segmentos en tiempo real:
Ejemplo sin emoji:
"Hola Juan, te recordamos tu entrevista manana a las 10am."
| Campo | Valor |
|---|---|
| Caracteres | 52/160 |
| Encoding | GSM-7 |
| Segmentos | 1 |
| Costo estimado | 1 SMS |
Ejemplo con emoji:
"Hola Juan, te recordamos..."
| Campo | Valor |
|---|---|
| Caracteres | 53 |
| Encoding | Unicode (emoji detectado) |
| Segmentos | 1 (max 70) |
GSM-7 vs Unicode
GSM-7 (160 chars/segmento):
- Letras A-Z, a-z
- Numeros 0-9
- Espacios
- Signos basicos: . , ! ? @ # $ etc
- Algunos caracteres especiales
Unicode (70 chars/segmento):
- Emojis
- Caracteres especiales
- Acentos no estandar
- Otros alfabetos
Recomendacion: Evita emojis para mensajes largos para maximizar caracteres.
Enviar SMS
- Selecciona hilo
- Click en SMS
- Escribe mensaje
- Observa contador de segmentos
- Click [Enviar]
Cuota de Mensajes
Verificar Cuota
El sistema trackea uso mensual:
WhatsApp:
| Campo | Valor |
|---|---|
| Usados | 850 / 1000 |
| Progreso | 85% |
| Ciclo termina | 15 feb |
SMS:
| Campo | Valor |
|---|---|
| Usados | 234 / 500 |
| Progreso | 47% |
| Ciclo termina | 15 feb |
Alertas de Cuota
Alerta al 90%:
Cuota de WhatsApp al 90% Te quedan 100 mensajes para este ciclo. [Ver opciones de plan]
Alerta de cuota agotada:
Cuota de SMS agotada No puedes enviar SMS hasta el proximo ciclo. [Contactar soporte]
Estados de Entrega
Ciclo de Vida
| Estado | Descripcion | Icono |
|---|---|---|
| QUEUED | Mensaje aceptado por Twilio, en cola de envio | - |
| SENT | Mensaje enviado a operador | checkmark |
| DELIVERED | Confirmacion del operador, mensaje llego al telefono | checkmark checkmark |
| READ | Destinatario abrio el mensaje (Solo WhatsApp) | checkmark checkmark azul |
| FAILED | No se pudo entregar, ver mensaje de error | warning |
Visualizacion
En el mensaje:
- checkmark - Enviado
- checkmark checkmark - Entregado
- checkmark checkmark (azul) - Leido (solo WhatsApp)
- warning - Fallido (con detalle de error)
El estado se actualiza en tiempo real via callbacks de Twilio.
Recepcion de Mensajes
Webhook de Twilio
Cuando llega un mensaje:
- Candidato envia mensaje
- Twilio recibe
- Webhook a nuestra API
- Sistema procesa:
- Identifica candidato por telefono
- Busca/crea hilo
- Guarda mensaje
- Actualiza unreadCount
- Emite WebSocket
- UI se actualiza en tiempo real
Identificacion de Candidato
El sistema busca por telefono:
+521 55 1234 5678 -> Busca en User.phone
- Si encuentra -> Usa ese candidato
- Si no -> Crea hilo generico
Importante: El telefono debe estar registrado en el perfil del candidato.
Configuracion
Credenciales de Twilio
Menu: Configuracion > Integraciones > Twilio
| Campo | Valor |
|---|---|
| Account SID | [AC...] |
| Auth Token | [oculto] |
| Numero SMS | [+52 55 1234 5678] |
| Numero WhatsApp | [+521 55 8765 4321] |
[Verificar conexion] [Guardar]
Credenciales por Defecto
Si la empresa no tiene credenciales propias:
- Se usan credenciales de plataforma
- Costos se cargan a la empresa
- Numero compartido
Errores Comunes
Mensajes de Error
| Error | Descripcion | Solucion |
|---|---|---|
| INVALID_NUMBER | Numero de telefono invalido | Verificar formato |
| UNDELIVERABLE | Telefono no alcanzable, fuera de servicio, numero no existe | Verificar numero |
| BLOCKED | Usuario bloqueo mensajes o numero en lista negra | Contactar por otro canal |
| QUOTA_EXCEEDED | Limite de mensajes alcanzado | Esperar nuevo ciclo |
| SESSION_EXPIRED | Sesion de 24h expiro (WhatsApp) | Enviar template para reiniciar |
| TEMPLATE_NOT_APPROVED | Template no aprobado (WhatsApp) | Usar template existente |
Soluciones
Para INVALID_NUMBER:
- Verifica el formato del numero
- +52 para Mexico
- +521 para WhatsApp Mexico movil
Para SESSION_EXPIRED:
- Envia un template para reiniciar la ventana de 24 horas
Para QUOTA_EXCEEDED:
- Contacta soporte para ampliar o espera al nuevo ciclo
Mejores Practicas
Para WhatsApp
DO:
- Responde rapido (mantiene sesion)
- Usa templates apropiados
- Personaliza variables
- Respeta horarios
DON'T:
- Spam de templates
- Mensajes muy largos
- Contenido no solicitado
- Ignorar respuestas (pierde sesion)
Para SMS
DO:
- Mensajes cortos y claros
- Incluye call-to-action
- Identifica tu empresa
- Respeta horarios
DON'T:
- Emojis en mensajes largos
- Links muy largos
- Multiples mensajes seguidos
- Mensajes en horarios inadecuados
Proximos Pasos
- Email - Comunicacion por correo
- Canales de Comunicacion - Vista general
- Tipos de Mensajes - Estados y direcciones