Conectar Twilio para SMS
El canal SMS usa Twilio y es el único canal con configuración por tenant: cada negocio puede usar su propio número Twilio para que los SMS lleguen con su identificador.
Requisitos previos
- Cuenta activa en twilio.com.
- Un número Twilio con capacidad SMS comprado o verificado.
- Acceso a tu Account SID y Auth Token.
Paso 1 — Obtener tus credenciales Twilio
1. En la consola de Twilio, ve a Account → API keys & tokens.
2. Copia el Account SID (empieza con AC).
3. Copia el Auth Token.
4. En Phone Numbers → Manage → Active numbers, copia el número en formato E.164 (p. ej. +15005550006).
Paso 2 — Ingresar las credenciales en el dashboard
1. Ve a /dashboard/settings → pestaña Canales.
2. En la sección SMS (Twilio), haz clic en Configurar.
3. Ingresa:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKENTWILIO_PHONE_NUMBER(formato E.164)
4. Haz clic en Guardar y verificar.
El sistema enviará un SMS de prueba al número de contacto del tenant para confirmar que la conexión funciona.
Variables de entorno equivalentes
Si estás en un entorno self-hosted, estas son las variables relevantes:
TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_PHONE_NUMBER=+15005550006
Verificar que funciona
Después de guardar:
1. Agenda una cita de prueba desde tu widget (/a/[slug]).
2. Proporciona un número de celular real cuando el agente lo pida.
3. Revisa que llegue el SMS de confirmación en los siguientes 30 segundos.
Solución de problemas
| Error | Causa probable | Solución |
|---|---|---|
| 21608 | Número no verificado en trial | Verifica el número en el sandbox de Twilio |
| 20003 | Credenciales incorrectas | Revisa Account SID y Auth Token |
| SMS no llega | Número sin capacidad SMS | Compra un número con SMS habilitado |
> Si tienes una cuenta Twilio en modo Trial, solo puedes enviar SMS a números verificados previamente en tu sandbox. Actualiza a cuenta de pago para producción.