API de WhatsApp para empresas
Resumen
Nuestra API de la Plataforma WhatsApp Business (WAB) te permite interactuar con usuarios de WhatsApp a través de tu cuenta de WhatsApp Business.
Esta es una breve descripción general que te guiará en el proceso de registro e incorporación a la API de WhatsApp Business. Contacta con tu proveedor actual de soluciones de mensajería para obtener una descripción general de las funciones y servicios de la aplicación WhatsApp Business.
Proceso de incorporación
Para consultar los precios de la API de WhatsApp Business y registrarse en ella, contacte con su gestor de cuentas.
Nuestro equipo de aprovisionamiento aprovisionará su API de WhatsApp Business para Mobile Gateway en nuestro sistema.
Deberá asignar un usuario con acceso a su cuenta de Facebook empresarial.
Nuestro equipo de aprovisionamiento le enviará por correo electrónico un enlace URL al usuario designado. Este lo dirigirá a nuestra interfaz y lo guiará a través del proceso de registro integrado.
Información del desarrollador
Consulte nuestra documentación de API para obtener detalles y ejemplos de código.
Registro integrado
Visita Proceso de registro integrado documentación para obtener detalles sobre el proceso y el papel que desempeñamos como su proveedor de soluciones de WhatsApp.
Plantillas de mensajes
Para obtener más información sobre cómo administrar plantillas de mensajes dentro de su aplicación WhatsApp Business existente, visite las Pautas de plantillas de mensajes o la Guía de la API de gestión empresarial: Plantillas documentación de Meta.
Webhooks
Visita este enlace para obtener más información sobre cómo administrar webhooks dentro de tu aplicación WhatsApp Business existente, o comuníquese con su proveedor de soluciones de plataforma de mensajería actual.
Respuestas MO
Solo recibirás mensajes MO si has configurado una URL de devolución de llamada MO dentro de tu Configuración API.
Recomendamos usar https:// para sus URL de respuesta.
Cuando se recibe un mensaje MO, se realiza una solicitud POST a la URL de devolución de llamada MO. Esta devolución de llamada incluirá los detalles del mensaje MO como un objeto JSON en el cuerpo de la solicitud POST.
POST callback-url
{
"id": str:id,
"source": str:source,
"Destination": str:destination,
"content": obj:content,
}
Estas son notificaciones que se incluirán en el contenido - Notificación de mensajes de WhatsApp
| Tipo de mensaje | Descripción |
|---|---|
| Audio | Audio / nota de voz. |
| Botón | Representa un botón de respuesta seleccionado por el usuario en respuesta a un mensaje de botón enviado por su empresa. |
| Contexto | Proporciona información sobre el mensaje al que este mensaje está respondiendo (hilo). |
| Documento | Documento / archivo (por ejemplo, PDF). |
| Errores | Enumera todos los errores asociados con el envío de un mensaje, generalmente incluidos cuando el estado es fallido. |
| Identidad | Indica un cambio en la información de identidad del usuario, como el número de teléfono o el perfil. |
| Imagen | Una imagen enviada por el usuario. La carga útil incluye metadatos multimedia. |
| Interactiva | Mensajes de tipo interacción (por ejemplo, respuestas a mensajes interactivos que envió su empresa, como mensajes de lista o botones). |
| Remisión | Metadatos que muestran cómo el usuario entró en contacto con su empresa (por ejemplo, clic en anuncio, código QR, enlace). |
| Etiqueta engomada | Medios adhesivos. |
| Sistema | Notificaciones a nivel de sistema, como cambios de identidad/número de teléfono del usuario. |
| texto | Mensaje de texto sin formato. |
| Plantilla | Representa un mensaje de plantilla enviado por la empresa, que incluye nombre, idioma y componentes dinámicos. |
| Tipo | Especifica el tipo de mensaje o evento, lo que ayuda al backend a analizar el contenido correctamente (por ejemplo, texto, imagen, interactivo, enviado, entregado). |
| Video | Un video enviado por un usuaria. |
El valor “base64” se suministrará para mensajes que contengan datos binarios. El contenido se suministrará codificado con base64, se necesita descifrar el contenido para obtener los datos originales. NOTA : los mensajes SMS normales con GSM de 7 bits o contenido Unicode no suministrarán este parámetro.
Mensajes DLR
Solo recibirá estados DLR si ha configurado una URL de devolución de llamada DLR dentro de su Configuración API.
Recomendamos usar https:// para sus URL de devolución de llamada.
Cuando se recibe un mensaje DLR, se realiza una solicitud POST a la URL de devolución de llamada de DLR. Esta devolución de llamada incluirá el detalle del estado de DLR como un objeto JSON en el cuerpo de la solicitud POST.
POST callback-url
{
"id": str:id,
"status": str:status,
"reference": str:reference,
}
Estado del mensaje DLR
Los siguientes son los códigos de estado devueltos en los DLR que nuestro portal de mensajes admite.
| Estado | Descripción |
|---|---|
| sent | El mensaje ha sido enviado por el operador transporte |
| received | Mensaje recibido |
| rejected | El operador rechazó el mensaje |
| expired | El operador no pudo entregar el mensaje en un período de tiempo específico. Por ejemplo, cuando el teléfono estaba apagado |
Especificación OpenAPI
La especificación OpenAPI (Swagger) se puede encontrar aquí: aqui
Puedes ver ejemplos de código y más información aqui.
Ayuda
¿Tienes problemas para integrarte con alguno de nuestros servicios? Contacto support@modicagroup.com y te ayudaremos a resolverlo.
