Twilio
Ten en cuenta que la compatibilidad con la integración de webhook de Twilio se interrumpirá el 31 de enero de 2020. Si deseas seguir accediendo a los servicios SMS con Braze, consulta nuestra documentación sobre SMS.
En este ejemplo, configuraremos el canal webhook de Braze para enviar SMS y MMS a tus usuarios, a través de la API de envío de mensajes de Twilio. Para tu comodidad, en el dashboard se incluye una plantilla de webhook de Twilio.
URL HTTP
Twilio proporciona la URL del webhook en tu dashboard. Esta URL es única para tu cuenta de Twilio, ya que contiene el ID de tu cuenta de Twilio (TWILIO_ACCOUNT_SID).
En nuestro ejemplo de Twilio, la URL del webhook es https://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json. Puedes encontrar esta URL en la sección Getting Started de la consola de Twilio.
Cuerpo de la solicitud
La API de Twilio espera que el cuerpo de la solicitud esté codificado como URL, así que tenemos que empezar por cambiar el tipo de solicitud en el compositor de webhook de Braze a Raw Text. Los parámetros obligatorios para el cuerpo de la solicitud son To, From y Body.
La siguiente captura de pantalla es un ejemplo del aspecto que podría tener tu solicitud si estás enviando un SMS al número de teléfono de cada usuario, con el cuerpo “Hello from Braze!”.
- Necesitarás tener números de teléfono válidos en cada perfil de usuario de tu audiencia objetivo.
- Para cumplir con el formato de solicitud de Twilio, utiliza el filtro
url_param_escapede Liquid en el contenido de tus mensajes. Este filtro codifica una cadena para que todos los caracteres estén permitidos en una solicitud HTML; por ejemplo, el carácter más (+) en el número de teléfono+12125551212está prohibido en los datos codificados en URL y se convertirá en%2B12125551212.
Encabezados de solicitud y método
Twilio requiere dos encabezados de solicitud: el tipo de contenido de la solicitud y un encabezado de autenticación básica HTTP. Añádelos a tu webhook haciendo clic en el ícono de engranaje situado junto al compositor del webhook y, a continuación, haciendo clic dos veces en Add New Pair.
| Nombre del encabezado | Valor del encabezado |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
| Authorization | Basic {{ 'TWILIO_ACCOUNT_SID:TWILIO_AUTH_TOKEN' | base64_encode }} |
Asegúrate de sustituir TWILIO_ACCOUNT_SID y TWILIO_AUTH_TOKEN por los valores de tu dashboard de Twilio. Por último, el punto de conexión de la API de Twilio espera una solicitud HTTP POST, así que elige esa opción en el desplegable de HTTP Method.
Vista previa de tu solicitud
Utiliza el compositor del webhook para obtener una vista previa de la solicitud para un usuario aleatorio, o para un usuario con credenciales concretas, para asegurarte de que la solicitud se renderiza correctamente.
