Objetos

Last update: 2 years ago by Irais Aguirre

Notificaciones de Mensajes

Estructura general notificaciones de mensajes

Nombre	Descripción	Tipo	Requerimientos
contacts	Objeto que contiene los datos del contacto que envió el mensaje.	Objecto	Obligatorio
messages	Objeto que contiene los datos del mensaje enviado.	Objeto	Obligatorio

Contacts

Nombre	Descripción	Tipo	Requerimientos
profile	Objeto que contiene los datos del contacto	Object	Obligatorio
wa_id	Teléfono (con código de país) que envío el mensaje.	String	Obligatorio

Messages

Nombre	Descripción	Tipo	Requerimientos
from	Teléfono (con código de país) que envío el mensaje.	String	Obligatorio
id	Identificador del mensaje	String	Obligatorio
timestamp	Fecha y hora de envío de mensaje	String	Obligatorio
type	De acuerdo al tipo de mensaje, el valor puede ser: text audio document image location video voice button (respuestas rápidas) contacts	String	Obligatorio
text	Objeto que contiene el texto del mensaje	Object	Opcional
audio	Objeto que contiene los datos del audio	Object	Opcional
document	Objeto que contiene los datos del documento	Object	Opcional
image	Objeto que contiene los datos de la imagen	Object	Opcional
location	Objeto que contiene los datos de la ubicación	Object	Opcional
video	Objeto que contiene los datos del video	Object	Opcional
voice	Objeto que contiene los datos del mensaje de voz	Object	Opcional
sticker	Objeto que contiene los datos del sticker	Object	Opcional
interactive	Objeto que contiene los datos de mensajes interactivos	Object	Opcional
button	Objeto que contiene el texto de repuesta rápida	Object	Opcional
context	Objeto que contiene información relacionada a los siguientes casos: cuando se recibe una notificación de tipo button cuando el cliente responde haciendo referencia a un mensaje propio o enviado por el negocio cuando el mensaje ha sido reenviado cuando el negocio envía un mensaje que menciona a uno o más teléfonos y su cliente responde haciendo referencia a este mensaje	Object	Se enviará en los siguientes casos: cuando se recibe una notificación de tipo button cuando el cliente responde haciendo referencia a un mensaje propio o enviado por el negocio cuando el mensaje ha sido reenviado cuando el negocio envía un mensaje que menciona a uno o más teléfonos y su cliente responde haciendo referencia a este mensaje
contacs	Objeto que contiene los datos del contacto.	Objeto	El obligatorio cuando se recibe una notificación de contacto compartido.

Profile

Nombre	Descripción	Tipo	Requerimientos
name	Nombre del contacto que envió el mensaje	String	Obligatorio

Texto

Nombre	Descripción	Tipo	Requerimientos
body	Texto del Mensaje.	String	Obligatorio.

Audio

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del archivo.	String	Obligatorio.
mime_type	Tipo de archivo.	String	Obligatorio.
sha256	Checksum del archivo.	String	Obligatorio.

Documento

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del archivo.	String	Obligatorio.
mime_type	Tipo de archivo.	String	Obligatorio.
sha256	Checksum del archivo.	String	Obligatorio.
caption	Texto que acompaña al documento.	String	Opcional.
filename	Nombre del archivo en el dispositivo del remitente.	String	Obligatorio.

Imagen

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del archivo.	String	Obligatorio.
mime_type	Tipo de archivo.	String	Obligatorio.
sha256	Checksum del archivo.	String	Obligatorio.
caption	Texto que acompaña a la imagen.	String	Opcional.

Ubicación

Nombre	Descripción	Tipo	Requerimientos
address	Dirección.	String	Obligatorio.
latitud	Latitud.	Number	Obligatorio.
longitud	Longitud.	Number	Obligatorio.
name	Nombre de la ubicación.	String	Obligatorio.
url	URL del sitio web de donde el usuario descargó la información de la ubicación.	String	Opcional.

Video

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del archivo.	String	Obligatorio.
mime_type	Tipo de archivo.	String	Obligatorio.
sha256	Checksum del archivo.	String	Obligatorio.
caption	Texto/Título que asigna el usuario al archivo que envía	String	Opcional, solo se encuentra presente si el usuario lo escribe.

Mensaje de voz

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del archivo.	String	Obligatorio
mime_type	Tipo de archivo.	String	Obligatorio
sha256	Checksum del archivo.	String	Obligatorio
caption	Texto/Título que asigna el usuario al archivo que envía.	String	Opcional, solo se encuentra presente si el usuario lo escribe.

Sticker

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del archivo.	String	Obligatorio.
mime_type	Tipo de archivo.	String	Obligatorio.
sha256	Checksum del archivo.	String	Obligatorio.
animated	Animado.	Boolean	Obligatorio.

Respuesta rápida para mensajes interactivos

Nombre	Descripción	Tipo	Requerimientos
context	Objeto que contiene información relacionada de un mensaje.	Object	Obligatorio.
button_reply	Botón de respuesta	Object	Obligatorio.

Objeto context mensajes interactivos

Nombre	Descripción	Tipo	Requerimientos
from	Teléfono (con código de país) del remitente del mensaje al que se hace referencia o del mensaje asociado al botón	String	Obligatorio.
id	Id del mensaje al que se hace referencia o del mensaje asociado al botón

Objeto button_reply

Nombre	Descripción	Tipo	Requerimientos
id	Id del botón.	String	Obligatorio.
title	Título del botón.	String	Obligatorio.

Respuesta rápida (tipo botón)

Nombre	Descripción	Tipo	Requerimientos
context	Objeto que contiene información relacionada de un mensaje.	Object	Obligatorio.
button	Botón.	Object	Obligatorio.

Objeto context tipo botón

Nombre	Descripción	Tipo	Requerimientos
from	Teléfono (con código de país) del remitente del mensaje al que se hace referencia o del mensaje asociado al botón	String	Obligatorio.
id	Id del mensaje al que se hace referencia o del mensaje asociado al botón	String	Obligatorio.

Objeto button

Nombre	Descripción	Tipo	Requerimientos
button	Payload.	String	Obligatorio.
text	Texto del botón.	String	Obligatorio.

Contacto compartido

Nombre	Descripción	Tipo	Requerimientos
from	Teléfono (con código de país) del que se enviará el mensaje.	String	Obligatorio.
to	Teléfono (con código de país) del cliente al que se le envía el mensaje. Se admiten signos más (+), guiones (-), paréntesis ((,)) y espacios.	String	Obligatorio.
type	El valor por defecto es “location”.	String	Obligatorio
contacts	VObjeto que contiene los datos del contacto.	Object	Obligatorio.

Objeto contacts

Nombre	Descripción	Tipo	Requerimientos
birthday	Fecha de nacimiento del Contacto.	String	Opcional.
addresses	Objeto que contiene las direcciones del Contacto	Object	Opcional.
emails	Objeto que contiene los emails del Contacto	Object	Opcional.
name	Objeto que contiene el nombre del Contacto.	Object	Obligatorio.
org	Objeto que contiene la compañía del Contacto.	Object	Opcional.
phones	Objeto que contiene los teléfonos del Contacto.	Object	Opcional.
urls	Objeto que contiene las URLs del Contacto.	Object	Opcional.

Objeto addresses

Nombre	Descripción	Tipo	Requerimientos
city	Ciudad.	String	Opcional.
country	País.	String	Opcional.
state	Estado.	String	Opcional.
street	Calle.	String	Opcional.
type	Los valores podrán ser: WORK, HOME.	String	Opcional.
zip	Código Postal.	String	Opcional.

Objeto emails

Nombre	Descripción	Tipo	Requerimientos
email	Correo del Contacto.	String	Opcional.
type	Los valores podrán ser: WORK.	String	Opcional.

Objeto name

Nombre	Descripción	Tipo	Requerimientos
first_name	Nombre del Contacto.	String	Obligatorio si middle_name y last_name no tienen valor.
middle_name	Segundo nombre del contacto.	String	Obligatorio si first_name y last_name no tienen valor.
last_name	Apellido del Contacto.	String	Obligatorio si middle_name y first_name no tienen valor.
formatted_name	Nombre Completo.	String	Obligatorio.

Objeto org

Nombre	Descripción	Tipo	Requerimientos
company	Nombre de la compañía.	String	Obligatorio

Objeto phones

Nombre	Descripción	Tipo	Requerimientos
phone	Teléfono del Contacto.	String	Obligatorio.
type	Los valores podrán ser: WORK, HOME.	String	Obligatorio.

Objeto urls

Nombre	Descripción	Tipo	Requerimientos
url	URL del contacto.	String	Obligatorio.
type	Los valores podrán ser: WORK.	String	Obligatorio.

Carro de compras

Nombre	Descripción	Tipo	Requerimientos
order	Orden de compras.	Object	Obligatorio.

Objeto order

Nombre	Descripción	Tipo	Requerimientos
catalog_id	Identificador del catálogo.	String	Obligatorio.
product_items	Lista de identificados de productos.	Lista Object	Obligatorio.

Objeto product item

Nombre	Descripción	Tipo	Requerimientos
currency	Tipo de moneda.	String	Obligatorio.
item_price	Precio del producto.	Number	Obligatorio.
product_retailer_id	Identificador del producto.	String	Obligatorio.
quantity	Cantidad a comprar.	Number	Obligatorio.

Notificaciones de Estatus

Estructura general notificaciones de estatus

Nombre	Descripción	Tipo	Requerimientos
id	Identificador del mensaje	String	Obligatorio.
recipient_id	Teléfono al que se le envió el mensaje	String	Obligatorio.
status	Los estatus del mensaje son: sent: mensaje enviado delivered: mensaje entregado read: mensaje leído failed: el mensaje no se pudo enviar deleted: el usuario eliminó el mensaje	String	Obligatorio.
timestamp	Fecha y hora en la que ocurrió el estatus.	String	Obligatorio
errors	En caso de algún error en el envío del mensaje, se presentará el objeto errors.	Objecto	Opcional
conversation	Atributos de la conversación actual.	Objecto	Opcional. Este dato puede no incluirse en algunas notificaciones
pricing	Atributos de facturación.	Objecto

Objeto conversation

Nombre	Descripción	Tipo	Requerimientos
id	Identificador de la conversación	String	Obligatorio.
origin	Describe la categoría de conversación. authentication marketing utility service referral_conversion
Objeto	Obligatorio

Objeto origin

Nombre	Descripción	Tipo	Requerimientos
type	- authentication: Indica que la conversación fue abierta por una empresa que envió una plantilla categorizada como mensaje de AUTHENTICATION a un cliente. marketing: Indica que la conversación fue abierta por una empresa que envió una plantilla categorizada como mensaje de MARKETING a un cliente. utility: Indica que la conversación fue abierta por una empresa que envió una plantilla categorizada como mensaje de UTILITY a un cliente. service: Indica que la conversación iniciada por una empresa respondiendo a un cliente dentro de una ventana de servicio al cliente. referral_conversion: Indica un punto de conversación de entrada libre.	String	Obligatorio.

Objeto pricing

Nombre	Descripción	Tipo	Requerimientos
billable	Indica si el mensaje o conversación dado es facturable. El valor varía de acuerdo al pricing_model. CBP: Es false si la conversación se inició desde puntos de entrada gratuitos. Para todas las demás conversaciones es true. También se establece como true para las conversaciones dentro del límite de su nivel gratuito. NBP: Es false para las conversaciones de servicio. Es true para conversaciones de autenticación, marketing y servicios públicos.	Boolean	Obligatorio
pricing_model	Tipo de modelo de precios que se utiliza. Los valores admitidos actuales son CBP y NBP.	String
category	Indica la categoría de precios de la conversación. business_initiated: Indica que la conversación iniciada por una empresa que envía el primer mensaje a un usuario. Esto se aplica cada vez que hayan pasado más de 24 horas desde el último mensaje del usuario. user_initiated: Indica que la conversación iniciada por una empresa que responde a un mensaje de usuario. Esto se aplica solo cuando la respuesta comercial se realiza dentro de las 24 horas posteriores al último mensaje del usuario. referral_conversion: Indica que la conversación se originó en un punto de entrada libre. Estas conversaciones siempre las inicia el usuario.	String

Objeto errors

Nombre	Descripción	Tipo	Requerimientos
code	Código de error. Para mayor detalle, ver sección Códigos de Error	Number	Obligatorio.
title	Descripción del error	String	Obligatorio
href	Url con mas detalle acerca del error	String	Opcional
id	Identificador del Mensaje	String	Obligatorio
recipient_id	Teléfono al que se le envió el mensaje	String	Obligatorio
status	Failed	String	Obligatorio
timestamp	Fecha y hora en la que ocurrió el error.	String	Obligatorio

Whatsapp — Anterior

Siguiente — Whatsapp