Integrar con Twilio
Pestañas
PlatoForms puede enviar mensajes de texto (SMS) para tus formularios: notificaciones de envío, invitaciones, solicitudes de documentos, renovaciones y tareas de flujo de trabajo. Por defecto, se envían a través de PlatoForms SMS, que se paga con tu saldo de crédito y utiliza un texto fijo. Si tienes una cuenta de Twilio, puedes conectarla y enviar esos textos a través de tu propio Twilio en su lugar.
PlatoForms SMS o tu propio Twilio
| PlatoForms SMS | Tu propio Twilio | |
|---|---|---|
| Remitente | Un remitente de PlatoForms | Tu Servicio de Mensajería de Twilio: tu número de teléfono o ID de remitente |
| Costo | Se paga con tu saldo de crédito de PlatoForms | Facturado por Twilio a tu cuenta. No se usa crédito de PlatoForms |
| Países | Los países que soporta PlatoForms SMS | Cualquier país al que tu cuenta de Twilio pueda enviar mensajes |
| Texto del mensaje | Fijado por PlatoForms | Lo escribes tú, con variables como el nombre del destinatario y el enlace |
| Aprobación para nuevas cuentas | Aprobación única | No necesaria |
¿No tienes cuenta de Twilio? No necesitas una: PlatoForms SMS envía tus textos sin ninguna configuración, y una empresa de EE.UU. o Canadá puede registrarse allí para enviar mensajes a números de EE.UU. Consulta Enviar mensajes de texto (SMS). Los dos servicios son independientes: registrarse en PlatoForms no cambia lo que tu cuenta de Twilio puede enviar.
Conectas Twilio una vez para tu equipo. Después eliges el servicio en cada lugar que envía textos, por lo que un formulario puede usar tu Twilio mientras otro permanece en PlatoForms SMS.
El envío de mensajes de texto requiere un plan de pago. La conexión de Twilio la realiza el propietario del equipo o un miembro con acceso a facturación. Si no ves la tarjeta Twilio en la página de Integraciones de un formulario, la función aún no está activada para tu equipo: contáctanos.
Antes de comenzar: lo que necesitas de Twilio
Recoge estos datos en la Consola de Twilio:
-
Un Servicio de Mensajería con un remitente en su grupo. Ve a Mensajería > Servicios, abre o crea un servicio, y añade un número de teléfono o un ID de remitente alfanumérico a su grupo de remitentes. Copia el SID del Servicio de Mensajería (comienza con
MG). -
Tu SID de Cuenta (comienza con
AC), mostrado bajo Información de la cuenta. -
Una clave API estándar. Ve a Cuenta > Claves API y tokens, crea una clave Estándar, y copia su SID (comienza con
SK) y su secreto. Twilio muestra el secreto solo una vez. Deja el selector de región en Estados Unidos (US1), el predeterminado. La región no limita los países a los que puedes enviar mensajes.
Usa una clave API, nunca tu Token de Autenticación de Twilio. Una clave API puede ser revocada por sí sola sin afectar nada más en tu cuenta de Twilio.
Para enviar mensajes a números de EE.UU., Twilio requiere que el Servicio de Mensajería tenga una campaña A2P 10DLC registrada o un número gratuito verificado. Otros países tienen sus propias reglas de remitente, y muchos aceptan un ID de remitente alfanumérico. Consulta las directrices de Twilio para los países a los que envías mensajes.
Conecta tu cuenta de Twilio
-
En el Panel, pasa el cursor sobre cualquier formulario, haz clic en Configuración (icono de engranaje) en la parte superior derecha, luego haz clic en Gestionar Formulario.
-
En la barra lateral izquierda, haz clic en Integraciones.
-
Encuentra la tarjeta Twilio y haz clic en Conectar. La página de Mensajería de texto se abre en una nueva pestaña del navegador, en su pestaña Tu propio Twilio.
NoteLa conexión es para todo tu equipo, así que lo haces una vez, desde cualquier formulario. También puedes abrir la página desde Plan y Facturación > Saldo de crédito: haz clic en Configuración de mensajería de texto junto a Mensajes SMS, luego en la pestaña Tu propio Twilio.
-
Bajo Conecta tu Twilio, ingresa el SID de Cuenta, SID del Servicio de Mensajería, SID de la Clave API y secreto de la clave API, luego haz clic en Conectar.
PlatoForms verifica la cuenta, el Servicio de Mensajería y sus remitentes con estas credenciales. No se envía nada. El secreto de la clave API se almacena cifrado.
-
Cuando la verificación pasa, Tu propio Twilio muestra Conectado, con los números o IDs de remitente de tu Servicio de Mensajería.
-
(Opcional) Bajo Enviar un texto de prueba, ingresa un número móvil y haz clic en Enviar texto de prueba para confirmar la entrega. Twilio te factura por este texto.
Usa tu Twilio para los textos de un formulario
Conectar Twilio no cambia nada por sí mismo. Cada sección de SMS sigue usando PlatoForms SMS hasta que la cambies.
-
Abre la configuración de SMS que deseas cambiar, por ejemplo Gestionar Formulario > Invitaciones o Gestionar Formulario > Notificaciones, y activa SMS.
-
Selecciona Tu propio Twilio.
-
Escribe el mensaje de texto. Haz clic en una variable junto a Insertar para añadirla. Lo que muestra el teléfono previsualiza el mensaje con valores de ejemplo, y te indica su longitud y cuántos textos se envía como.
-
Guarda tus cambios.
Puedes hacer esta elección en cada uno de estos lugares:
| Dónde | Qué textos |
|---|---|
| Notificaciones | El texto enviado cuando se envía el formulario |
| Invitaciones | La invitación y su recordatorio |
| Solicitudes de documentos | El enlace de documentos, los recordatorios y la solicitud de una nueva carga |
| Renovación | El aviso de renovación |
| Notificaciones de pasos de flujo de trabajo | El texto enviado para una tarea de flujo de trabajo |
Reglas para tu propio texto
- Un texto puede tener hasta 320 caracteres. Un mensaje largo se envía como varios textos; la previsualización muestra cuántos.
- Usa solo las variables ofrecidas para ese texto. Donde el texto entrega un enlace (invitaciones, solicitudes de documentos, renovaciones y tareas de flujo de trabajo), debe contener
{{ link }}. - PlatoForms añade una línea de exclusión voluntaria a cada texto: “Responde STOP para excluirte.” cuando el remitente es un número de teléfono, o un enlace de exclusión voluntaria cuando es un ID de remitente alfanumérico, que no puede recibir respuestas. Si tu Servicio de Mensajería tiene ambos, Twilio usa el ID de remitente alfanumérico donde el país lo permite (en todas partes excepto EE.UU. y Canadá), por lo que esos textos terminan con el enlace de exclusión voluntaria.
- Un texto se verifica cuando lo guardas. Un texto que solicita contraseñas, detalles de pago o información personal no es aceptado.
- Envía mensajes solo a personas que han aceptado recibir mensajes de texto de ti. Los límites diarios por destinatario y por formulario aún se aplican, para proteger a las personas a las que envías mensajes.
| Variable | Inserta | Disponible en |
|---|---|---|
{{ team }} |
El nombre de tu equipo | Cada texto |
{{ form }} |
El nombre del formulario | Cada texto |
{{ name }} |
El nombre del destinatario | Invitaciones |
{{ link }} |
El enlace que el destinatario abre | Invitaciones, Solicitudes de documentos, Renovación, Pasos de flujo de trabajo |
{{ workflow }}, {{ step }} |
El nombre del flujo de trabajo y el nombre del paso | Pasos de flujo de trabajo |
{{ item }}, {{ expires }} |
El nombre del documento y su fecha de vencimiento | Renovación |
Facturación y uso
- Los textos enviados a través de tu Twilio son facturados por Twilio a tu cuenta. PlatoForms no cobra por ellos, y no usan tu saldo de crédito.
- Aún aparecen en la página de Uso bajo SMS, a $0.00.
- Las secciones que permanecen en PlatoForms SMS funcionan como antes y se pagan con tu saldo de crédito.
Reemplazar la clave API o desconectar
- Reemplazar la clave: crea una nueva clave API en Twilio, abre la página de Mensajería de texto (haz clic en Configurar en la tarjeta Twilio), e ingresa la clave bajo Reconectar tu Twilio.
- Desconectar: haz clic en Desconectar tu Twilio. El secreto de la clave API se elimina de PlatoForms. Las secciones configuradas en Tu propio Twilio vuelven a PlatoForms SMS con el texto estándar. Tu elección y tus textos se mantienen, y se usan de nuevo cuando te reconectas.
- Necesita atención: si Twilio deja de aceptar la clave, por ejemplo, después de que la revoques, la conexión muestra Necesita atención y el propietario del equipo recibe un correo electrónico. Hasta que te reconectes, esas secciones usan PlatoForms SMS, que necesita crédito en tu saldo.
Solución de problemas
| Lo que ves | Qué hacer |
|---|---|
| “Este Servicio de Mensajería no tiene remitente.” | En Twilio, añade un número de teléfono o un ID de remitente alfanumérico al grupo de remitentes del servicio, luego conéctalo de nuevo |
| Los mensajes a números de EE.UU. no se entregan | Registra una campaña A2P 10DLC para el Servicio de Mensajería, o usa un número gratuito verificado |
| “Conecta tu cuenta de Twilio primero.” | Conecta Twilio en la página de Mensajería de texto antes de elegir Tu propio Twilio |
| “Este texto no fue aceptado.” | Elimina el texto que solicita contraseñas, detalles de pago o información personal |
| Una sección configurada en Tu propio Twilio usa tu saldo de crédito | Tu Twilio está desconectado o necesita atención. Reconéctalo en la pestaña Tu propio Twilio |
| “Este Servicio de Mensajería no tiene remitente registrado en EE.UU.” | Registra una campaña A2P 10DLC o verifica un número gratuito en tu consola de Twilio. Registrar tu negocio bajo PlatoForms SMS no soluciona esto |