/ /

Servicios de terceros

Docs Home

/ /

Referencia

Servicios de terceros

Docs Home

MongoDB Atlas

Servicios de aplicaciones Atlas

Referencia

Servicios de terceros

Servicio Twilio

Atlas App Services ha llegado al final de su ciclo de vida y MongoDB ya no ofrece soporte activo. Los activadores siguen disponibles en la interfaz de usuario de Atlas. Consulte Página de desuso para más detalles.

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.

Los webhooks se han renombrado como puntos finales HTTPS sin cambios en su 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 ofrece servicios de mensajería, voz y chat para aplicaciones web y móviles. El servicio Atlas App Services de Twilio permite integrar el servicio de SMS programables de Twilio en su aplicación.

Para enviar un mensaje de texto saliente, utilice la acción send().
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. guía.

Parámetros de configuración

Necesitará proporcionar valores para los siguientes parámetros cuando cree una interfaz de servicio Twilio:

<Service Name>/config.json

{
  "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	Un identificador único para tu cuenta de Twilio. Puedes encontrar este valor en el panel de control de tu cuenta de Twilio.
Twilio Authorization Token secret_config.auth_token	El nombre de un secreto que almacena un token de autorización de Twilio, lo que demuestra que eres el propietario de una cuenta de Twilio. Puedes encontrar este valor en el panel de tu cuenta de Twilio.

Acciones de servicio

El servicio Twilio en App Services proporciona las siguientes acciones, disponibles en funciones y en los SDK:

Para obtener instrucciones sobre el uso de una acción de servicio,consulte Llamar una acción de servicio.

Acción	Descripción
`twilio.send()`	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 de servicio de Twilio están obsoletos y se sustituyen por endpoints HTTPS personalizados. Para saber cómo migrar sus webhooks de Twilio a endpoints, consulte Convertir webhooks a endpoints HTTPS.

Los webhooks entrantes para el servicio Twilio permiten que tu aplicación gestione los mensajes de texto entrantes. Una vez creado un webhook entrante, puedes añadirlo a un servicio de mensajería Twilio para gestionar los mensajes entrantes de ese servicio.

Configuración

Necesitará proporcionar valores para los siguientes parámetros cuando cree un webhook entrante de Twilio:

Necesitará proporcionar un archivo de configuración con el siguiente formato cuando cree 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. Nota Cada webhook entrante en una interfaz de servicio Twilio debe tener un nombre único.
Respond With Result respond_result	Obligatorio. Si es `true`, App Services envía el valor de retorno de la función de webhook a Twilio en el cuerpo de la respuesta. Nota Twilio enviará automáticamente un mensaje de texto con el cuerpo de la respuesta del webhook al número de teléfono que envió el mensaje inicial.
Run Webhook As run_as_user_id run_as_user_id_script_source	Opcional. El ID del usuario de App Services que ejecuta la función de webhook cuando se llama a este. Existen tres formas de configurar el usuario de ejecución: System:El usuario de ejecución es el usuario del sistema, que tiene acceso completo a las API de CRUD y agregación de MongoDB y omite todas las reglas y la validación del esquema. User Id:Selecciona un usuario de aplicación específico para ejecutar la función. Script:Define una función que devuelve el `id` del usuario de ejecución. Puede especificar el ID de usuario directamente en `run_as_user_id` o proporcionar una función Atlas convertida en cadena que acepte la carga útil del webhook y devuelva el ID de usuario `run_as_user_id_script_source` en. Si no especifica un ID de usuario específico ni una función que lo resuelva, App Services ejecuta la función del webhook como el usuario del sistema con acceso completo a las API CRUD y de agregación de MongoDB, y omite todas las reglas y la validación del esquema.

Solicitud de carga útil

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
`From`	Una cadena que contiene el número de teléfono con formato E.164que envió el mensaje de texto entrante.
`To`	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.
`Body`	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?"
}

Ejemplo de función de webhook

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.
Haga clic en el servicio de mensajería que desea utilizar.
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.

Tu aplicación ya está integrada con el servicio de mensajería SMS de Twilio. Envía un mensaje a tu número de teléfono de Twilio para invocar el webhook entrante de tu aplicación.

Volver

http.head()

Twilio.send()