Last updated
Last updated
Webhooks son devoluciones de llamada HTTP definidas por el usuario que se desencadenan por eventos específicos. Cada vez que se produce un evento desencadenante, el cliente de la API empresarial de WhatsApp verá el evento, recopilará los datos e inmediatamente enviará una notificación (solicitud HTTP) a la URL de WhatsApp especificada en la configuración de la aplicación, actualizando el estado de los mensajes enviados o indicando cuándo recibir un mensaje
Es importante que su Webhook devuelva una respuesta HTTPS 200 OK a las notificaciones. De lo contrario, el cliente de la API empresarial de WhatsApp considerará que esta notificación es un error y volverá a intentarlo después de un retraso.
webhooks: proporcione la URL para su Webhook. OBlIGATÓRIO cuando estás usando Webhooks. Si la URL de Webhook no está definida, se eliminan las devoluciones de llamada.
Siempre que sea posible, los nombres se mantendrán constantes en todas las funciones. (Por ejemplo, todas las marcas de tiempo se llamantimestamp
.
Todos los campos posibles del Webhook de notificación se muestran a continuación.
Ejemplo
Cuando se producen errores fuera de banda en el funcionamiento normal de la aplicación, la matriz de errores proporcionará una descripción del error. Este tipo de error puede ser causado por errores temporales de conectividad de red, credenciales no válidas, controladores de administración con estado no disponible, etc. Si recibe un error, consulte Mensajes de error y estado para obtener más información.
Ejemplo
El objeto de errores El objeto de errores contiene los siguientes parámetros:
Recibirá una notificación cuando su empresa reciba un mensaje. La sección del objeto de mensajes a continuación presenta toda la información que se puede recibir sobre un mensaje entrante.
Cuando se recibe el mensaje de medios, el cliente de la API empresarial de WhatsApp descarga los medios. Se envía una notificación a su Webhook cuando se descargan los medios. Este mensaje contiene información que identifica el objeto multimedia y le permite encontrar y recuperar el objeto. Use el punto final de medios con la identificación de medios para recuperarlo.
Los usuarios pueden responder a un mensaje específico en WhatsApp. Para que la empresa comprenda el contexto de la respuesta a un mensaje, incluimos el objeto de contexto. Este objeto de contexto proporciona la identificación del mensaje a la que respondió el cliente y la identificación de WhatsApp del remitente del mensaje original.
Los mensajes del sistema se generan cuando ocurre un evento, por ejemplo, un usuario agrega / elimina otro usuario o deja un grupo, etc. Consulte la sección de objetos del sistema a continuación para obtener más información.
Por ejemplo, se recibieron los siguientes mensajes del sistema (1) cuando un usuario se unió a un grupo y (2) cuando un administrador agregó un icono al grupo.
Positus sigue los estándares API exactamente igual que el estándar oficial de Facebook / WhatsApp. La documentación completa y actualizada se puede encontrar en el siguiente enlace:
Nombre del campo
Descripción
Tipo
code
Código de error
Numérico
title
Título do error
Cadena de caracteres
details
Opcional. Detalles del error proporcionados, si están disponibles / aplicables
Cadena de caracteres
href
Opcional. Detalles de la ubicación del error.
Cadena de caracteres
Nombre
contenido del objeto
mensajes
Notificaciones de mensajes entrantes
estados
Actualizaciones de estado del mensaje
errores
Graves errores fuera de banda
Cuando el cliente le envía un mensaje, el cliente API de WhatsApp Business enviará una notificación de solicitud HTTP POST a la URL de Webhook con los detalles que se describen en este manual.