Existen varios tipos de contenido en bruto (no estructurado) que puedes enviar a tus usuarios.

• Texto
• Imagen
• Audio
• Video
• Archivo
• Carrusel
• Botones
• Respuesta rápida
• Medios
• Respuesta pública

Texto​

Texto

{
  type: "TEXT",
  text: "¡Hola Mundo!"
}

Imagen​

Imagen

{
  type: "IMAGE",
  url: "http://image.png",
  attachment_id: "SomeStringID"
}

nota

• La imagen debe estar en un formato válido de archivo de imagen, incluyendo .jpg, .jpeg, .png, .gif, .tiff y .bmp
• El tamaño máximo del archivo es 2MB
• Puedes enviar botones de Respuesta rápida junto con una imagen
  

Audio​

Audio

{
  type: "AUDIO",
  url: "http://audio.mp3",
  attachment_id: "SomeStringID",
}

nota

• El audio debe estar en un formato válido de archivo de audio, incluyendo .aac, .flac, .m4a, .m4p, .mp3, .wav y .wma
• Puedes enviar botones de Respuesta rápida junto con un mensaje de audio
  

Video​

Video

{
  type: "VIDEO",
  url: "http://video.mp4",
  attachment_id: "SomeStringID"
}

nota

• El video debe estar en un formato válido de archivo de video, incluyendo .mkv, .gif, .avi, .wmv, .rmvb, .mp4, .m4v, .mpg, .mpeg y .3gp
• El tamaño máximo del archivo es 25MB
• Puedes enviar botones de Respuesta rápida junto con un video
  

Archivo​

Archivo

{
  type: "FILE",
  url: "http://file.pdf",
  attachment_id: "SomeStringID",
}

nota

• El archivo debe estar en un formato válido, incluyendo .pdf
• El tamaño máximo del archivo es 25MB
• Puedes enviar botones de Respuesta rápida junto con un archivo
  

Carrusel​

El carrusel es una fila horizontal desplazable de elementos, cada uno compuesto por un archivo adjunto de imagen, descripción corta y botones para solicitar una acción a los usuarios.

Carrusel

{
  type: "CAROUSEL",
  carousel: [{
    title: "Camiseta clásica",
    subtitle: "Gris medio\n$29.99",
    image_url: "http://img.url",
    default_action: {
      type: "web_url",
      url: "https://zuckstees.com"
    },
    buttons: [{
      type: "web_url",
      url: "https://sanuker.com",
      title: "Ver detalles"
    }, {
      type: "postback",
      title: "Comprar ahora",
      payload: "UN_PAYLOAD_LARGO_AQUÍ"
    }, {
      type: "phone_number",
      title: "algún título 3",
      payload: "NÚMERO_DE_TELÉFONO"
    }]
  }],
  image_aspect_ratio: "square"
}

nota

• Puedes enviar botones de Respuesta rápida junto con un carrusel
• No necesariamente debes incluir botones en un carrusel si no se desea un llamado a la acción
  

Botones​

Botón

{
  type: "BUTTON",
  text: "¿En qué puedo ayudar?",
  buttons: [{
    type: "web_url",
    url: "https://sanuker.com",
    title: "Ver estado del pedido"
  }, {
    type: "phone_number",
    title: "Llámanos",
    payload: "NÚMERO_DE_TELÉFONO"
  }, {
    type: "postback",
    title: "algún título 2",
    payload: "UN_PAYLOAD_LARGO_AQUÍ"
  }]
}

Botón URL​

Botones URL

Abrir vista web

El botón URL se puede usar para abrir una página web en el navegador integrado de la aplicación. Este botón se puede usar con la plantilla de Botones, Carrusel y Lista. La vista web puede mostrarse de tres formas diferentes: compacta, alta o completa.

{
  type: "web_url",
  title: "algún título",
  url: "https://sanuker.com",
  webview_height_ratio: "tall",
  messenger_extensions: true,
  fallback_url: "https://sanuker.com",
  webview_share_button: "hide",
  urlTracking: false,
}

La analítica para URL puede activarse al crear el botón URL en la respuesta.

Una vez que un usuario haga clic en el botón URL, se registrará y se mostrará en el panel de analíticas.

Botón de postback​

Botón de postback

El botón de postback ayuda a invocar una acción en tu chatbot. Puedes asignar un payload al botón.

{
  type: "postback",
  title: "algún título",
  payload: "algún payload",
}

Botón de llamada​

Botón de llamada

El botón de llamada se puede usar para iniciar una llamada telefónica directamente.

{
  type: "phone_number",
  title: "Llámanos",
  payload: "+85281930208"
}

Botón de inicio de sesión​

Botón de inicio de sesión

El botón de inicio de sesión puede usarse para vincular una cuenta de usuario de un tercero a Facebook Messenger.

    {
      "type": "account_link",
      "url": "https://stella.sanuker.com"
    }

Respuesta rápida​

La respuesta rápida ofrece una forma diferente de presentar botones en un mensaje. Contiene texto y una imagen opcional.

La única diferencia entre Respuesta rápida y Botón es que Respuesta rápida solo aparece una vez y desaparece cuando se hace clic, mientras que el Botón permanece en el mensaje incluso después de hacer clic. Esto previene el escenario donde los usuarios podrían tocar botones de Respuesta rápida antiguos adjuntos a mensajes anteriores en la conversación.

Respuestas rápidas de Facebook

{
  type: "QUICK_REPLIES",
  text: "algún texto",
  quickReplies: [{
    content_type: "text",
    title: "Rojo",
    payload: "PAYLOAD_STRING",
    image_url: "http://red.img.url"
  }, {
    content_type: "text",
    title: "Verde",
    payload: "PAYLOAD_STRING",
    image_url: "http://green.img.url"
  }, {
    content_type: "text"
  }]
}

NOTA

• La imagen para image_url debe ser al menos 24x24 y se recortará y redimensionará.
• Si el usuario no tiene teléfono o correo electrónico en el perfil, los botones de respuesta rápida "user_phone_number" y "user_email" no se mostrarán.
  

Medios​

Los medios son similares a un carrusel sin título ni subtítulo, pero también pueden mostrar videos.

Medios de Facebook

{
  type: "MEDIA",
  media_type: "image",
  attachment_id: "attachmentId",
  buttons: [{
    type: "postback",
    title: "¡Muéstrame más!",
    payload: "UN_PAYLOAD_LARGO_AQUÍ"
  }]
}

nota

• Puedes enviar botones de Respuesta rápida junto con una plantilla de medios
  

Respuesta pública​

Respuesta pública se refiere a la respuesta de comentario a los comentarios de usuarios en publicaciones de Facebook.

Respuesta pública de Facebook

{
  type: "PUBLIC_REPLY",
  text: "algún texto",
  attachment_id: "attachmentId",
  attachment_url: "https://img.url"
}

Tipos de mensajería​

Meta soporta 3 tipos de mensajería para asegurar que el mensaje enviado cumple con las políticas de mensajería y las preferencias del destinatario.

Consulta aquí para más detalles sobre los tipos de mensajería.

Respuesta​

{
  "type": "TEXT",
  "messagingMeta": {
    "messaging_type": "RESPONSE"

  },
  "text": "Texto de prueba"

}

Actualizaciones​

{
  "type": "TEXT",
  "messagingMeta": {
    "messaging_type": "UPDATE"

  },
  "text": "Texto de prueba"

}

Etiqueta de mensaje​

{
  "type": "TEXT",
  "messagingMeta": {
    "tag": "ACCOUNT_UPDATE",
    "messaging_type": "MESSAGE_TAG"

  },
  "text": "Texto de prueba"

}