Mensajes para empezar una conversación

Los mensajes para empezar una conversación brindan a los usuarios la posibilidad de iniciar una conversación con una lista de preguntas frecuentes. Es posible configurar un máximo de 4 preguntas con la API de mensajes para empezar una conversación.

A partir del 19 de octubre de 2021, los mensajes para empezar una conversación admiten la localización para permitir a las empresas establecer preguntas personalizadas en función de la ubicación del usuario. La API tendrá un nuevo formato, y recomendamos a los desarrolladores que lo aprovechen al configurar y recuperar información de los mensajes para empezar una conversación. Se puede encontrar aquí la lista de idiomas admitidos.

Configurar mensajes para empezar una conversación

Nuevo formato (recomendado)

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

Formato antiguo (no debería usarse para la nueva configuración de los mensajes para empezar una conversación)

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

Obtener mensajes para empezar una conversación

Según la configuración de los mensajes para empezar una conversación, la solicitud GET devolverá un formato diferente. Se aplica el siguiente comportamiento:

• Si los mensajes para empezar una conversación se configuraron con el viejo formato, la solicitud GET devolverá la respuesta en el formato antiguo.
• En cambio, si los mensajes para empezar una conversación se configuraron con el nuevo formato, la solicitud GET devolverá la respuesta en el nuevo formato.

Recomendamos a los desarrolladores migrar al nuevo formato, ya que, en el futuro, dejaremos sin efecto el antiguo formato.

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

Nuevo formato de respuesta

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

Formato antiguo de respuesta

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

Eliminar mensajes para empezar una conversación

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Evento del webhook

Para recibir webhooks de postback de los mensajes para empezar una conversación, es necesario que la app esté suscrita a la versión 8.0 o posteriores del webhook messaging_postbacks en el tema de Instagram, en la configuración de la app.

El webhook recibirá una carga JSON similar a la del ejemplo que figura a continuación:

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}