Existem vários tipos de conteúdo bruto (não estruturado) que podem ser enviados aos seus usuários.

• Texto
• Imagem
• Áudio
• Vídeo
• Arquivo
• Carrossel
• Botões
• Resposta rápida
• Mídia
• Resposta pública

Texto​

Texto

{
  type: "TEXT",
  text: "Olá Mundo!"
}

Imagem​

Imagem

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

nota

• A imagem deve ser um formato válido de arquivo, incluindo .jpg, .jpeg, .png, .gif, .tiff e .bmp
• O tamanho máximo do arquivo é 2MB
• Você pode enviar botões de Resposta rápida junto com uma imagem
  

Áudio​

Áudio

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

nota

• O áudio deve ser um formato válido de arquivo de áudio, incluindo .aac, .flac, .m4a, .m4p, .mp3, .wav e .wma
• Você pode enviar botões de Resposta rápida junto com uma mensagem de áudio
  

Vídeo​

Vídeo

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

nota

• O vídeo deve estar em um formato válido de arquivo de vídeo, incluindo .mkv, .gif, .avi, .wmv, .rmvb, .mp4, .m4v, .mpg, .mpeg e .3gp
• O tamanho máximo do arquivo é 25MB
• Você pode enviar botões de Resposta rápida junto com um vídeo
  

Arquivo​

Arquivo

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

nota

• O arquivo deve ser um formato válido, incluindo .pdf
• O tamanho máximo do arquivo é 25MB
• Você pode enviar botões de Resposta rápida junto com um arquivo
  

Carrossel​

Carrossel é uma linha rolável horizontal de itens, cada um composto por um anexo de imagem, descrição curta e botões para solicitar ações dos usuários.

Carrossel

{
  type: "CAROUSEL",
  carousel: [{
    title: "Camiseta clássica",
    subtitle: "Cinza médio\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 detalhes"
    }, {
      type: "postback",
      title: "Comprar agora",
      payload: "UM_PAYLOAD_LONGO_AQUI"
    }, {
      type: "phone_number",
      title: "algum título 3",
      payload: "NÚMERO_DE_TELEFONE"
    }]
  }],
  image_aspect_ratio: "square"
}

nota

• Você pode enviar botões de Resposta rápida junto com um carrossel
• Você não precisa necessariamente incluir botões em um carrossel se nenhuma call-to-action for pretendida
  

Botões​

Botão

{
  type: "BUTTON",
  text: "Como posso ajudar?",
  buttons: [{
    type: "web_url",
    url: "https://sanuker.com",
    title: "Ver status do pedido"
  }, {
    type: "phone_number",
    title: "Me ligue",
    payload: "NUMERO_DE_TELEFONE"
  }, {
    type: "postback",
    title: "algum título 2",
    payload: "UM_PAYLOAD_LONGO_AQUI"
  }]
}

Botão URL​

Botões URL

Abrir visualização web

O botão URL pode ser usado para abrir uma página da web no navegador interno do aplicativo. Este botão pode ser usado com o Template de Botões, Carrossel e Lista. A visualização web pode ser renderizada de três formas diferentes: compacta, alta ou completa.

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

A Análise de URL pode ser ativada ao criar o Botão URL na resposta.

Quando um usuário clicar no botão URL, isso será rastreado e registrado no painel de análise.

Botão Postback​

Botão Postback

O Botão Postback ajuda a invocar uma ação no seu chatbot. Você pode definir um payload para o botão.

{
  type: "postback",
  title: "algum título",
  payload: "algum payload",
}

Botão de chamada​

Botão de chamada

O Botão de chamada pode ser usado para iniciar uma ligação telefônica diretamente.

{
  type: "phone_number",
  title: "Ligue para nós",
  payload: "+85281930208"
}

Botão de login​

Botão de login

O Botão de login pode ser usado para vincular uma conta de usuário de terceiros ao Facebook Messenger.

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

Resposta rápida​

A Resposta rápida oferece uma forma diferente de apresentar botões em uma mensagem. Contém texto e uma imagem opcional.

A única diferença entre Resposta rápida e Botão é que a Resposta rápida aparece apenas uma vez e desaparece após ser clicada, enquanto o Botão permanece na mensagem mesmo após o clique. Isso previne o cenário onde os usuários poderiam tocar em botões antigos de Resposta rápida anexados a mensagens anteriores na conversa.

Respostas rápidas do Facebook

{
  type: "QUICK_REPLIES",
  text: "algum texto",
  quickReplies: [{
    content_type: "text",
    title: "Vermelho",
    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

• A imagem para image_url deve ter pelo menos 24x24 e será cortada e redimensionada.
• Se o usuário não tiver número de telefone ou email no perfil, os botões de resposta rápida "user_phone_number" e "user_email" não serão exibidos.
  

Mídia​

Mídia é similar a um carrossel sem título e legenda, mas também pode exibir vídeo.

Mídia do Facebook

{
  type: "MEDIA",
  media_type: "image",
  attachment_id: "attachmentId",
  buttons: [{
    type: "postback",
    title: "Mostre mais!",
    payload: "UM_PAYLOAD_LONGO_AQUI"
  }]
}

nota

• Você pode enviar botões de Resposta rápida junto com um template de mídia
  

Resposta pública​

Resposta pública refere-se à resposta a comentários dos usuários em publicações do Facebook.

Resposta pública do Facebook

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

Tipos de mensagem​

A Meta suporta 3 tipos de mensagem para garantir que a mensagem enviada esteja em conformidade com as políticas de mensagens e as preferências do destinatário.

Consulte aqui para mais detalhes sobre os tipos de mensagem.

Resposta​

{
  "type": "TEXT",
  "messagingMeta": {
    "messaging_type": "RESPONSE"
  },
  "text": "Texto de teste"
}

Atualizações​

{
  "type": "TEXT",
  "messagingMeta": {
    "messaging_type": "UPDATE"
  },
  "text": "Texto de teste"
}

Etiqueta de mensagem​

{
  "type": "TEXT",
  "messagingMeta": {
    "tag": "ACCOUNT_UPDATE",
    "messaging_type": "MESSAGE_TAG"
  },
  "text": "Texto de teste"
}