messages
Esta devolución de llamada se producirá cuando se haya enviado un mensaje a tu página. Los mensajes siempre se envían en orden. Es posible que recibas mensajes de texto o mensajes con archivos adjuntos.
Los archivos adjuntos de tipo image
, audio
, video
, file
y reel
son los tipos admitidos principales. También puedes recibir archivos adjuntos de tipo fallback
. Un ejemplo habitual de un archivo adjunto de este tipo es una situación en que un usuario comparte una URL con una página y se crea un archivo adjunto basado en el uso compartido de enlaces. Si los usuarios comparten contenido con la página de un modo que no se admite, es posible que se envíe un archivo adjunto de tipo fallback
sin ninguna carga útil.
Para suscribirte a esta devolución de llamada, selecciona message
al configurar tu webhook.
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "quick_reply": { "payload": "<DEVELOPER_DEFINED_PAYLOAD>" } } }
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"m_1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "reply_to": { "mid":"m_1fTq8oLumEyIp3Q2MR-aY7IfLZDamVrALniheU" } } }
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
El webhook de mensaje con una plantilla de producto solo está disponible para la versión 8.0 y posteriores de la API Graph.
Este webhook se aplica al escenario en el cual un usuario comparte productos de otras conversaciones o procesos de uso compartido en la página. Este webhook se limita únicamente a los productos que pertenecen a la página. La aplicación necesitará tener aprobado el permiso catalog_management
para recibir los detalles del producto en los webhooks.
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
Ejemplo aplicable a messages
para la versión 6.0 y posteriores.
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1583173667623, "messaging": [ { "sender": { "id": "<PSID>" }, "recipient": { "id": "<PAGE_ID>" }, "timestamp": 1583173666767, "message": { "mid": "m_toDnmD...", "text": "This is where I want to go: https:\/\/youtu.be\/bbo_fZAjIhg", "attachments": [ { "type": "fallback", "payload": { "url": "<ATTACHMENT_URL >", "title": "TAHITI - Heaven on Earth" } } ] } } ] } ] }
El webhook de mensaje de la página de detalles del producto de tiendas solo está disponible para la versión 8.0 y posteriores de la API Graph.
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "referral": { "product": { "id":"<PRODUCT_ID>" } } } }
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1697643211842, "messaging": [ { "sender": { "id": "<PSID>" }, "recipient": { "id": "<PAGE_ID>" }, "timestamp": 1697643027400, "message": { "mid": "m_3vs...", "text": "find flights from SFO to LAX next Thursday", "commands": [ { "name": "flights" } ] } } ] } ] }
sender
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | PSID del usuario que activó el evento del webhook. |
| Cadena | Valor user_ref del usuario que activó el evento del webhook. Solo está disponible para eventos del webhook del plugin de chat. |
recipient
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Identificador de la página. |
message
Para la versión 6.0 y posteriores, sticker_id
se movió de message
a message.attachments.payload
.
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Identificador del mensaje. |
| Cadena | Texto del mensaje. |
| Objeto | Datos personalizados opcionales que proporciona la aplicación que lleva a cabo el envío. |
| Objeto | Referencia al identificador del mensaje (mid) al que responde este mensaje. |
| Matriz< | Matriz con datos de los archivos adjuntos. |
| Objeto | Referencia del mensaje de la página de detalles del producto de tiendas. |
message.quick_reply
Una carga útil de quick_reply
solo se proporciona con un mensaje de texto cuando el usuario toca un botón de respuestas rápidas.
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Datos personalizados que proporciona la aplicación. |
message.reply_to
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Referencia al identificador del mensaje al que responde este mensaje. |
message.attachments
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena |
|
| Cadena |
message.attachments.payload
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | URL del tipo de archivo adjunto. Aplicable a los archivos adjuntos de tipo |
| Cadena | Título del archivo adjunto. Aplicable a los archivos adjuntos de tipo |
| Número | Identificador persistente de este sticker (por ejemplo, |
| Número | Identificador del vídeo asociado al reel adjunto. Aplicable a los archivos adjuntos de tipo |
message.attachments.payload.product.elements
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Identificador del producto del catálogo de productos de Facebook. |
| Cadena | Identificador externo asociado con el producto (p. ej.: el SKU o el identificador del contenido). |
| Cadena | URL del producto. |
| Cadena | Título del producto. |
| Cadena | Subtítulo del producto. |
message.referral
La carga útil de referral
solo se proporciona cuando el usuario envía un mensaje desde la página de detalles del producto de tiendas.
Propiedad | Tipo | Descripción |
---|---|---|
| Objeto | Información sobre el producto. |
message.referral.product
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Identificador del producto. |
message.commands
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Nombre del comando. |