SMS con Twilio

Sin Twilio, la app no envía SMS: las automatizaciones con canal SMS no entregan, y el acceso por teléfono no está disponible, porque es Twilio quien envía el código.

Antes de empezar

• Plan: cualquiera, incluido Free;
• Cuenta en Twilio, con una tarjeta registrada para comprar un número;
• Costo en dos lugares:
  • Twilio cobra el número (cuota mensual) y cada SMS, en tu cuenta, según su tabla;
  • cada SMS enviado por la app consume créditos de integración de la plataforma, y el SMS es el canal de aviso más caro en créditos. Eso incluye cada código de acceso por SMS. El débito solo ocurre cuando Twilio acepta el envío.

Paso a paso

Campos de la tarjeta: Account SID, Auth Token y Número remitente.

1. crea la cuenta en twilio.com;
2. en la Console de Twilio, la página de inicio muestra el Account SID (empieza con AC) y el Auth Token (haz clic para mostrarlo);
3. en Phone Numbers → Manage → Buy a number, compra un número con capacidad de SMS. Algunos países exigen un registro regulatorio antes de habilitar el número: la propia Twilio indica cuándo es el caso;
4. en el editor de la app, pestaña Integraciones, categoría Notificaciones, abre la tarjeta SMS (Twilio);
5. completa el Account SID, el Auth Token y, en Número remitente, el número comprado en formato internacional, con + y el código del país (por ejemplo, +5511999999999);
6. haz clic en Guardar y activar.

Cuenta de prueba (trial)

Mientras la cuenta de Twilio está en trial, solo envía a números verificados y el mensaje llega con un prefijo de prueba. Para probar, registra tu número en Verified Caller IDs en la Console. Para la app en uso, la cuenta tiene que salir del trial.

Acceso por teléfono

Con Twilio conectado, la app puede ofrecer el acceso con número de teléfono y un código recibido por SMS, y la recuperación de contraseña por el mismo camino. No se activa en la pestaña Autenticación: lo que lo habilita es tener Twilio conectado. El resto está en Registro e inicio de sesión en tu app.

Conviene planificar el saldo: cada intento de acceso por SMS es un SMS pagado en Twilio y un débito en créditos de integración. Con el saldo de créditos en cero, el código no se envía y la persona no puede entrar por teléfono.

Cómo saber que funcionó

La tarjeta de Twilio no prueba la credencial al guardar: Conectada significa que los campos se guardaron. La prueba es un SMS real:

• si la app tiene acceso por teléfono, pide un código con tu número;
• o pide en el chat un botón de prueba que te envíe un SMS (eso gasta créditos de IA, como cualquier construcción).

En la Console de Twilio, en Monitor → Logs → Messaging, cada intento aparece con su estado y, si falló, el motivo.

Problemas comunes

• No llega ningún SMS y no aparece nada en los logs de Twilio. La credencial está mal. Abre la tarjeta y vuelve a escribir el campo que esté mal (un campo en blanco conserva el valor guardado);
• Aparece en los logs como fallo para números no verificados. La cuenta está en trial. Verifica el número de destino o sal del trial;
• Se rechaza el número remitente. Tiene que ser un número de tu cuenta de Twilio con capacidad de SMS, escrito con + y el código del país;
• Dejó de enviar de un momento a otro. Revisa el saldo de créditos de integración, en el panel en Facturación, y el saldo de la propia cuenta de Twilio.