messages
Esta devolución de llamada se producirá cuando se envíe un mensaje a tu página. Los mensajes siempre se envían en orden. Puedes recibir mensajes de texto o mensajes con archivos adjuntos.
Los principales tipos de adjuntos admitidos son image
, audio
, video
, file
y reel
. También es posible que recibas archivos adjuntos fallback
. Un ejemplo común de este tipo de archivo adjunto se da cuando un usuario comparte una URL con una página y se crea un archivo adjunto en función del uso compartido del enlace. Cuando los usuarios comparten elementos no admitidos con tu página, es posible que se envíe un archivo adjunto de fallback
sin carga.
Para suscribirte a esta devolución de llamada, selecciona el campo message
durante la configuración de 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 plantilla de producto solo está disponible en la versión 8.0 y versiones posteriores de la API Graph.
Este webhook se aplica a una situación en la que el usuario comparte productos de otros hilos o cuando se comparte un proceso con la página. Este webhook está limitado solo a los productos que son propiedad de la página. La app deberá tener el permiso catalog_management
aprobado para recibir detalles del producto en los webhooks.
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
Ejemplo aplicable a messages
en las versiones 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 las tiendas solo está disponible en 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
sender Field | Description |
---|---|
| The Page-scoped ID for the person who sent a message to your business |
| The reference for a person who used the Chat Plugin to messsage your business |
recipient
recipient Field | Description |
---|---|
| The ID for your Facebook Page |
message
En las versiones 6.0 y posteriores, sticker_id
se transfirió de message
a message.attachments.payload
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | El identificador del mensaje. |
| Cadena | El texto del mensaje. |
| Objeto | Datos personalizados opcionales proporcionados por la app que realiza el envío. |
| Objeto | Referencia al identificador del mensaje (mid) al que responde este mensaje. |
| Matriz de < | La matriz que contiene datos del archivo adjunto. |
| Objeto | La referencia del mensaje de la página de detalles del producto de las tiendas. |
message.quick_reply
Solo se proporciona una carga quick_reply
con un mensaje de texto cuando el usuario toca el botón Respuestas rápidas.
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Datos personalizados opcionales proporcionados por la app. |
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 | La URL del tipo de archivo adjunto. Aplicable al tipo de archivo adjunto: |
| Cadena | El título del archivo adjunto. Aplicable al tipo de archivo adjunto: |
| Número | El identificador persistente de este sticker, por ejemplo |
| Número | ID del vídeo asociado al reel adjunto. Aplicable al tipo de archivo adjunto: |
message.attachments.payload.product.elements
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | Identificador de producto del catálogo de productos de Facebook |
| Cadena | Identificador externo asociado al producto. (p. ej.: identificador de contenido/SKU) |
| Cadena | La URL del producto. |
| Cadena | Título del producto |
| Cadena | Subtítulo del producto |
message.referral
Solo se proporciona la carga referral
cuando el usuario envía un mensaje desde la página de detalles del producto de las tiendas.
Propiedad | Tipo | Descripción |
---|---|---|
| Objeto | Información del producto. |
message.referral.product
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | ID del producto. |
message.commands
Propiedad | Tipo | Descripción |
---|---|---|
| Cadena | El nombre del comando |