API DE MENSAJES

Envía y recibe SMS con la API de mensajes

Una API de mensajería es una interfaz programática que permite a tu empresa enviar, recibir y gestionar mensajes utilizando solicitudes HTTP estandarizadas. Con la API de mensajes de Sinch Engage, puedes enviar mensajes de WhatsApp y mensajes de texto, solicitar informes de entrega, consultar el estado por ID de mensaje y recuperar respuestas.

Image for Envía y recibe SMS con la API de mensajes

FLUJOS DE TRABAJO PRINCIPALES

Qué puedes hacer con la API de mensajes

Usa la API de mensajes para enviar mensajes de WhatsApp y de texto, hacer un seguimiento del estado de procesamiento, recuperar respuestas y confirmarlas después de procesarlas.

Imagen para Qué puedes hacer con la API de mensajes

Envío programado

Envía un mensaje de texto con un parámetro scheduled. Úsalo para la mensajería basada en tiempo, como los recordatorios de citas.

Informes de entrega

Solicita informes de entrega cuando envías un mensaje. Un informe de entrega es una notificación que se envía cuando cambia el estado del mensaje.

Comprobaciones de estado por ID de mensaje

Captura el ID de mensaje de la respuesta de envío. Úsalo para comprobar el estado del mensaje más tarde.

Respuestas y confirmación

Recupera las respuestas enviadas desde un teléfono llamando a la función de respuesta. Confirma las respuestas procesadas para que no se devuelvan de nuevo.

CÓMO FUNCIONA

Qué hace la API de mensajes

Envía SMS y mensajes de WhatsApp pasando el contenido, número de destino, opciones de programación, preferencias de informes de entrega y metadatos opcionales. La API devuelve un ID de mensaje que puedes usar para comprobar el estado y recuperar respuestas del teléfono.

INTEGRACIÓN

Cómo la API de mensajes se integra con tus sistemas existentes

Integra la API de mensajes con peticiones HTTP estándar o un SDK para adaptarla a tus sistemas existentes. Añade una callback_url para habilitar webhooks, e incluye metadatos para pasar contexto de mensaje personalizado.

Imagen para Cómo la API de mensajes se integra con tus sistemas existentes

CAPACIDADES

Capacidades de la API de mensajes

La API de mensajes admite un flujo de trabajo estructurado para enviar mensajes y gestionar respuestas, para que puedas incorporar la mensajería en tus aplicaciones.

  • Envía mensajes con contenido y destination_number

  • Programa mensajes con scheduled

  • Solicita informes de entrega con delivery_report

  • Comprueba el estado de los mensajes por ID de mensaje

  • Recupera respuestas de los teléfonos

  • Confirma respuestas e incluye hasta 10 pares de metadatos

Imagen para Capacidades de la API de mensajes

MEJORA TU FLUJO DE TRABAJO

Empieza a usar la API de mensajes

Para empezar, necesitarás una cuenta de Sinch Engage y tener Ruby instalado. Después, instala el SDK de Ruby para enviar mensajes, comprobar actualizaciones de estado y recuperar respuestas.

Instala el SDK de Ruby para empezar a desarrollar con la API de mensajes.

Crea un archivo app.rb en la carpeta de tu proyecto y ábrelo en tu editor.

Envía un mensaje con contenido y número de destino. También puedes incluir metadatos, programación y ajustes de informes de entrega.

Usa el ID de mensaje en la respuesta para comprobar el estado del mensaje. Llama a la función de respuesta para recuperar las respuestas de los teléfonos de los destinatarios.

Confirma las respuestas procesadas para que no aparezcan de nuevo en futuras comprobaciones. Añade una callback_url en send_message para habilitar webhooks.

Imagen para Empieza a usar la API de mensajes

¿POR QUÉ SINCH ENGAGE?

¿Por qué elegir una aplicación con capacidades de API?

Sinch Engage combina una aplicación fácil de usar con capacidades de API para que tu equipo pueda lanzar y gestionar la mensajería sin flujos de trabajo que dependan excesivamente de los desarrolladores. Obtienes la facilidad de uso que necesitan los equipos de negocio y la flexibilidad de integración que esperan los equipos técnicos.

Preguntas frecuentes

Preguntas frecuentes sobre la API de mensajes

Una API de mensajería es una interfaz programática que permite a las aplicaciones enviar, recibir y gestionar mensajes mediante peticiones HTTP estandarizadas. La API de mensajes es una forma de implementar ese patrón.

En el tutorial de la API de mensajes, el cuerpo del mensaje a enviar incluye campos como content y destination_number. También puede incluir metadata, scheduled y delivery_report.

Cuando envías un mensaje, la API de mensajes devuelve un ID de mensaje en el objeto de respuesta. Usa ese ID de mensaje para comprobar el estado del mensaje.

Las respuestas enviadas desde un teléfono aparecen cuando llamas a la función de respuesta en el flujo de trabajo del tutorial. Después de procesar las respuestas, confírmalas para que no se devuelvan de nuevo.

En el tutorial de la API de mensajes, puedes activar webhooks incluyendo un parámetro callback_url en el cuerpo del mensaje de tu función send_message. El material de origen no especifica un comportamiento adicional del webhook.

Sí. La API de mensajes admite hasta 10 pares clave-valor de metadatos en un mensaje. Usa metadatos cuando no quieras almacenar datos persistentes en la aplicación.

Necesitas una cuenta de desarrollador de MessageMedia y tener Ruby instalado. El tutorial también hace referencia a la instalación del SDK de Ruby con gem install messagemedia_messages_sdk.

Los informes de entrega son notificaciones sobre un cambio en el estado de un mensaje mientras se procesa. En el flujo de trabajo del tutorial, puedes solicitar delivery_report en el cuerpo del mensaje.

Sí. El tutorial muestra un campo scheduled en el cuerpo del mensaje. También describe recordatorios de citas con una confirmación un día antes y un recordatorio una hora antes.

Después de procesar uno o más mensajes de respuesta, confírmalos con el punto de conexión de confirmación de respuestas. Las respuestas confirmadas no se devuelven en peticiones posteriores para comprobar respuestas.