Importante
Servicios de terceros y notificaciones push obsoletos
Los servicios de terceros y las notificaciones push en App Services han quedado obsoletos en favor de la creación de puntos finales HTTP que usan dependencias externas en funciones.
Webhooks se han renombrado a HTTPS Endpoints sin cambios en el comportamiento. Debe migrar los Webhooks existentes.
Los servicios existentes continuarán funcionando hasta el de septiembre 30 2025de.
Dado que los servicios de terceros y las notificaciones push ya no se utilizan, se han eliminado de forma predeterminada de la interfaz de usuario de App Services. Si necesita administrar un servicio de terceros o una notificación push existente, puede volver a agregar las configuraciones a la interfaz de usuario siguiendo estos pasos:
En la navegación izquierda, debajo del Manage sección, haga clic en App Settings.
Habilite el interruptor junto a Temporarily Re-Enable 3rd Party Services y luego guarde los cambios.
Overview
Twilio provides messaging, voice, and chat services for web and mobile apps. The Atlas App Services Twilio service supports integrating Twilio's Programmable SMS service into your application.
To send an outbound text message, use the send() action.
Para manejar y responder opcionalmente a los mensajes de texto entrantes, cree un webhook entrante y Añádelo a un servicio de mensajería de Twilio. Consulta la sección de webhooks entrantes de esta página para ver un ejemplo.
Nota
Para usar Twilio con App Services, debes tener un Twilio Phone Number número registrado en un servicio de mensajería asociado a tu cuenta de Twilio. Puedes crear un nuevo número desde la Numbers página del panel de Twilio o siguiendo la Guía de inicio rápido de SMS programables de Twilio. guide.
Parámetros de configuración
Necesitará proporcionar valores para los siguientes parámetros cuando cree una interfaz de servicio Twilio:
{ "name": "<Service Name>", "type": "twilio", "config": { "sid": <Twilio Account SID> }, "secret_config": { "auth_token": "<Secret Name>" } }
Parameter | Descripción |
|---|---|
Service Name config.name | El nombre de esta interfaz de servicio de Twilio. Debe ser único respecto a las demás interfaces de servicio de su aplicación. |
Twilio Account SID config.sid | A unique identifier for your Twilio account. You can find this value on your Twilio account dashboard. |
Twilio Authorization Token secret_config.auth_token | The name of a Secret that stores a Twilio authorization token, which proves that you are the owner of a Twilio account. You can find this value on your Twilio account dashboard. |
Acciones de servicio
El servicio Twilio en App Services proporciona las siguientes acciones, disponibles en funciones y en los SDK:
Para instrucciones sobre cómo usar una acción de servicio, consulta Llamar a una acción de servicio.
Acción | Descripción |
|---|---|
Envía un mensaje de texto a un número de teléfono especificado. |
Webhooks entrantes
Nota
Convertir webhooks de Twilio en puntos finales
Los webhooks del servicio Twilio están en desuso en favor de HTTPS endpoints personalizados. Para saber cómo migrar tus webhooks de Twilio existentes a endpoints, consulta Convertir Webhooks a HTTPS Endpoints.
Los webhooks entrantes para el servicio Twilio permiten que tu aplicación gestione mensajes de texto entrantes. Una vez que hayas creado un webhook entrante, puedes añadirlo a un servicio de mensajería de Twilio para gestionar los mensajes entrantes de ese servicio.
Configuración
Necesitarás proporcionar valores para los siguientes parámetros cuando crees un webhook de entrada de Twilio:
Necesitarás proporcionar un archivo de configuración de la siguiente forma cuando crees un webhook entrante de Twilio.
{ "name": <string>, "respond_result": <boolean>, "run_as_user_id": <string>, "run_as_user_id_script_source": <string>, }
Valor de configuración | Descripción |
|---|---|
Webhook Name name | Obligatorio. El nombre del webhook. NotaEach incoming webhook in a Twilio service interface must have a unique name. |
Respond With Result respond_result | Obligatorio. Si es NotaTwilio enviará automáticamente un mensaje de texto con el cuerpo de la respuesta del webhook al teléfono que envió el mensaje inicial. |
Run Webhook As run_as_user_id run_as_user_id_script_source | Optional. The id of the App Services user that executes the webhook function when the webhook is called. Existen tres formas de configurar el usuario de ejecución:
Puede especificar el ID de usuario directamente en |
Carga útil de la solicitud
App Services pasa automáticamente un documento payload como primer argumento a las funciones de webhook entrantes. En un webhook entrante de Twilio Service, el objeto payload representa un mensaje SMS entrante y tiene el siguiente formato:
{ "From": "<Sender's Phone Number>", "To": "<Receiver's Phone Number>", "Body": "<SMS Body>" }
Campo | Descripción |
|---|---|
| Una cadena que contiene el número de teléfono con formato E.164que envió el mensaje de texto entrante. |
| Una cadena que contiene el número de teléfono con formato E.164asociado con su servicio de mensajería Twilio al que se envió el mensaje de texto entrante. |
| Una cadena que contiene el contenido del mensaje de texto entrante. |
Ejemplo
Un mensaje de texto enviado desde el número de teléfono (555)867-5309 al número de teléfono Twilio (805)716-6646 con el mensaje "Hello! How
are you?" estaría representado por el siguiente documento payload:
{ "From": "+15558675309", "To": "+18057166646", "Body": "Hello! How are you?" }
Example Webhook Function
La siguiente función de webhook almacena los mensajes de texto enviados a un número de teléfono de Twilio en una colección de MongoDB y envía una respuesta de mensaje de texto al número de teléfono que envió el texto.
exports = async function(payload, response) { // const { To, From, Body } = payload; const mongodb = context.services.get("mongodb-atlas"); const texts = mongodb.db("demo").collection("texts"); try { // Save the text message body, to number, and from number const { insertedId } = await texts.insertOne(payload); // Send the user a confirmation text message response.setBody(`Saved your text message with _id: ${insertedId}`); } catch (error) { // Send the user an error notification text message response.setBody(`Failed to save your text message: ${error}`); } }
Configurar Twilio
Crear un servicio de mensajería
Inicia sesión en Twilio.
Haga clic en Programmable SMS en el menú de navegación izquierdo de su proyecto Twilio.
Haga clic en SMS > Messaging Services.
Haga clic en Create new Messaging Service.
Ingresa un Friendly Name y un Use Case
Haga clic Create
Agregar un webhook a un proyecto Twilio
Haga clic en Programmable SMS en el menú de navegación izquierdo de su proyecto Twilio.
Haga clic en SMS > Messaging Services.
Click the messaging service that you want to use.
En la página de configuración del servicio de mensajería, marque la casilla PROCESS INBOUND MESSAGES.
Introduzca la URL del webhook entrante en el cuadro Request URL.
Haga clic en Save.
Your App is now integrated with Twilio's SMS messaging service. Send a message to your Twilio phone number to invoke the incoming webhook for your App.