Creación
Crea y envía mensajes a tus clientes o a las personas interesadas en tu página de Facebook.
Antes de empezar
Necesitarás lo siguiente:
Un identificador de acceso a la página que deberá solicitar la persona que puede realizar la tarea MESSAGE
en la página.
El permiso pages_messaging
.
El destinatario del mensaje debe haber enviado un mensaje a tu página en las últimas 24 horas o haber aceptado recibir mensajes de ella fuera del intervalo de 24 horas admitido.
Limitaciones
Ten en cuenta que la API de envío no incluye recipient_id
en la respuesta en el caso de los mensajes enviados mediante recipient.user_ref
o recipient.phone_number
para identificar al destinatario del mensaje.
Solicitud de ejemplo
Para enviar un mensaje a una persona, envía una solicitud POST
al extremo /PAGE-ID/messsages
con los parámetros messaging_type
y recipient
configurados y el contenido del mensaje.
El formato se ha modificado con fines de legibilidad.El siguiente ejemplo constituye la respuesta solo de texto al mensaje que una persona ha enviado a tu página.
curl -i -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages
?recipient={'id':'PSID'}
&messaging_type=RESPONSE
&message={'text':'hello,world'}
&access_token=PAGE-ACCESS-TOKEN
Si se envía correctamente, la aplicación recibirá la siguiente respuesta en formato JSON:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
Parámetros
Parámetro | Descripción | message object | El tipo de mensaje que envía tu página. Se debe configurar text o attachement al usar este parámetro. |
messaging_type enumObligatorio | El tipo mensaje que se envía RESPONSE : mensaje en respuesta a otro recibido. Esto incluye los mensajes promocionales y no promocionales que se envían dentro del intervalo de 24 horas de mensajes estándar. Por ejemplo, usa esta etiqueta para responder si una persona solicita una confirmación de reserva o una actualización de estado. UPDATE : mensaje que se envía de forma proactiva y no como respuesta a un mensaje recibido. Esto incluye los mensajes promocionales y no promocionales que se envían dentro del intervalo de 24 horas de mensajes estándar.
|
notification_type enum | Tipo de notificación push que una persona recibe NO_PUSH : ninguna notificación.
REGULAR (predeterminada): sonido o vibración cuando una persona recibe el mensaje.
SILENT_PUSH : solo notificaciones en pantalla.
|
recipient objetoObligatorio | La persona que recibirá el mensaje que envía tu página id : identificador específico de la página de la persona, que se utiliza para enviar un mensaje en respuesta a otro que ha recibido tu página en las últimas 24 horas, o de la persona que ha aceptado recibir mensajes de tu página fuera del intervalo de 24 horas de mensajes estándar.
user_ref : referencia de la persona que se utiliza para enviar un mensaje en respuesta al plugin Checkbox o de chat con clientes.
comment_id : identificador del comentario que se utiliza para enviar un mensaje como respuesta privada al comentario de un visitante en la publicación de la página.
post_id : identificador de la publicación de la página que se utiliza para enviar un mensaje como respuesta privada a la publicación de un visitante en tu página.
|
sender_action enum | El icono de acción que se muestra en la ventana de mensajes y que representa la acción que realiza la página respecto del mensaje que una persona le ha enviado. typing_on : muestra el cuadro de escritura cuando la página está preparando una respuesta.
typing_off : no muestra el cuadro de escritura.
mark_seen : muestra el icono de mensaje visto en los mensajes que la página ya ha leído.
Solo se puede enviar con el parámetro recipient . No se puede enviar con el parámetro message , pero se debe enviar como una solicitud independiente. |
tag enum | Etiqueta que permite a la página enviar un mensaje a una persona fuera del intervalo de 24 horas de mensajes estándar. ACCOUNT_UPDATE : etiqueta el mensaje que envías al cliente como actualización no recurrente a su aplicación o cuenta. Consulta los usos admitidos. No disponible para la API de mensajes de Instagram. CONFIRMED_EVENT_UPDATE : etiqueta el mensaje que envías al cliente como recordatorio de un evento próximo o como actualización de un evento en curso al que se ha registrado. Consulta los usos admitidos. No disponible para la API de mensajes de Instagram. HUMAN_AGENT : obligatorio para la API de mensajes de Instagram. Cuando se añade esta etiqueta a un mensaje que se envía a una persona, un agente humano puede responder al mensaje de dicha persona. Los mensajes se pueden enviar en un plazo de siete días a partir del mensaje que ha enviado la persona. La asistencia mediante agente humano es para resolver problemas que no se pueden solucionar en el intervalo de mensajes estándar. Consulta los usos admitidos. El permiso Human Agent no está disponible en modo de desarrollo o acceso estándar. Deberás completar el proceso de revisión de la aplicación para poder usar la etiqueta de agente humano. Durante el envío de la aplicación al proceso de revisión, proporciona instrucciones claras y una demostración de cómo intentas usar la etiqueta de agente humano en tus experiencias. POST_PURCHASE_UPDATE : etiqueta el mensaje que envías al cliente como una actualización de una compra reciente que este ha realizado. Consulta los usos admitidos. No disponible para la API de mensajes de Instagram.
|
Uso de etiquetas de mensaje
La siguiente tabla enumera los tipos de mensajes que corresponden a cada etiqueta de mensaje.
Uso de | etiquetas de mensaje | ACCOUNT_UPDATE
| Usos permitidosNotificación de cambio de estado de una aplicación, por ejemplo, una solicitud de tarjeta de crédito o de empleo Notificación de actividad sospechosa, como alertas por fraude
Usos no admitidos (lista no exhaustiva)Contenido promocional, incluidos, entre otros, ofertas, promociones, cupones y descuentos; contenido recurrente, como avisos de extractos listos, facturas adeudadas, nuevos anuncios de empleo Invitaciones para completar una encuesta o dejar una opinión que no guarda relación con la interacción anterior en Messenger
No disponible para la API de mensajes de Instagram. |
CONFIRMED_EVENT_UPDATE
| Usos permitidosRecordatorio de una clase, una cita o un evento próximos que un usuario ha programado Confirmación de la reserva de un usuario o la asistencia a un evento o una cita aceptados Notificación sobre el transporte o el viaje programado de un usuario, como horario de llegada, cancelación, retraso en la recepción del equipaje o cambios en el estado del viaje
Usos no admitidos (lista no exhaustiva)Contenido promocional, incluidos, entre otros, ofertas, cupones y descuentos Contenido relacionado con un evento al que el usuario no se ha registrado (por ejemplo, recordatorios para comprar entradas a un evento, venta cruzada de otros eventos, programas de giras, etc.) Mensajes relacionados con eventos anteriores Invitaciones para completar una encuesta o dejar una opinión que no guarda relación con la interacción anterior en Messenger
No disponible para la API de mensajes de Instagram. |
CUSTOMER_FEEDBACK
| Usos permitidosUsos no admitidos (lista no exhaustiva)No disponible para la API de mensajes de Instagram. |
HUMAN_AGENT
| Usos permitidosAsistencia mediante agente humano para resolver problemas que no se pueden solucionar en el intervalo de 24 horas de mensajes estándar, por ejemplo, problemas fuera del horario laboral o cuya resolución requiere más de 24 horas
Usos no admitidos (lista no exhaustiva)Obligatorio para la API de mensajes de Instagram. |
POST_PURCHASE_UPDATE
| Usos permitidosConfirmación de una transacción, como facturas o recibos Actualización de estado de un envío, como producto en tránsito, enviado, entregado o retrasado Actualización de estado que requiere que un usuario realice una acción respecto de un pedido que ha realizado, como una tarjeta de crédito rechazada, artículos con entrega retrasada por falta de stock u otras actualizaciones relativas a un pedido que requieren que el usuario tome medidas
Usos no admitidos (lista no exhaustiva)Contenido promocional, incluidos, entre otros, ofertas, promociones, cupones y descuentos Mensajes que realizan ventas cruzadas o dirigidas de productos o servicios Invitaciones para completar una encuesta o dejar una opinión que no guarda relación con la interacción anterior en Messenger
No disponible para la API de mensajes de Instagram. |