Botões

A maioria dos modelos de mensagem, assim como o menu persistente, é compatível com botões que invocam diferentes tipos de ação. Esses botões permitem que você ofereça facilmente, ao destinatário da mensagem, ações que poderão realizar em resposta ao modelo, como abrir o WebView do Messenger, iniciar um fluxo de pagamento, enviar uma mensagem de postback ao webhook e outras.

Para modelos de mensagens, os botões são definidos por objetos na matriz buttons. Para o menu persistente, os botões são definidos por objetos na matriz call_to_actions.

Botão de URL

O botão URL abre uma página da web no webView do Messenger. Isso permite que você enriqueça a conversa com uma experiência baseada na web, em que você conta com toda a flexibilidade de desenvolvimento da web. Por exemplo, você poderia exibir o resumo de um produto na conversa, depois usar o botão URL para abrir a página completa do produto no seu site.

Links de apps

Caso o site tenha links de apps, o botão iniciará o app nativo especificado.

O rastreador do Facebook precisa ler as metatags do link do app para que o redirecionamento funcione. Se você tiver implementado recentemente as tags no seu site, será possível solicitar uma nova raspagem com a ferramenta Depurador de Compartilhamento. Depois que o rastreador fizer a raspagem do site, os novos botões URL enviados deverão seguir o comportamento de redirecionamento.

Uso compatível

O botão URL é compatível com o uso do seguinte:

• Menu persistente
• Modelo genérico
• Modelo de lista
• Modelo de botão
• Modelo de mídia

SDK de extensões do Messenger - Obrigatório incluir domínio na lista de liberação

Formato do botão

Para ver uma lista completa das propriedades do botão, consulte Referência do botão URL.

{
  "type": "web_url",
  "url": "

Botão de postback

O botão de postback envia um evento messaging_postbacks para o seu webhook com a string definida na propriedade payload. Isso permite que você realize ações arbitrárias quando o botão for tocado. Por exemplo, você poderia exibir uma lista de produtos, depois enviar o número de identificação do produto no postback ao seu webhook, onde poderia ser usada para consultar seu banco de dados e retornar os detalhes sobre o produto na forma de uma mensagem estruturada.

Uso compatível

O botão de postback é compatível com o uso do seguinte:

• Menu persistente
• Modelo genérico
• Modelo de lista
• Modelo de botão
• Modelo de mídia

Formato do botão

Para ver uma lista completa das propriedades do botão, consulte Referência do botão de postback.

{
  "type": "postback",
  "title": "

Botão Ligar

O botão Chamar disca um número de telefone quando tocado. O número de telefone deve estar no formato +<COUNTRY_CODE><PHONE_NUMBER> (por exemplo, +15105559999).

Uso compatível

O botão de chamada é compatível com o uso do seguinte:

• Modelo genérico
• Modelo de lista
• Modelo de botão
• Modelo de mídia

Formato do botão

Para ver uma lista completa das propriedades do botão, consulte Call Button Reference.

{
  "type":"phone_number",
  "title":"

Botão Entrar

O botão Entrar é usado no fluxo de vinculação de conta para vincular a identidade do destinatário da mensagem no Messenger com a conta dele no seu site, direcionando a pessoa ao seu fluxo de login baseado na web para autenticação.

Para saber mais sobre como usar o botão Entrar para vinculação de conta, consulte Vinculação de conta.

Uso compatível

O botão de login é compatível com o uso do seguinte:

• Modelo genérico
• Modelo de lista
• Modelo de botão
• Modelo de mídia

Formato do botão

Para ver uma lista completa das propriedades do botão, consulte Log In Button Reference.

{
  "type": "account_link",
  "url": "

Botão Sair

O botão Sair é usado no fluxo de vinculação de conta para desvincular a identidade do destinatário da mensagem no Messenger com a conta dele no seu site.

Para saber mais sobre como usar o botão Sair para desvinculação de conta, consulte Vinculação de Conta.

Uso compatível

O botão de logout é compatível com o uso do seguinte:

• Modelo genérico
• Modelo de lista
• Modelo de botão
• Modelo de mídia

Formato do botão

Para ver uma lista completa das propriedades do botão, consulte Log Out Button Reference.

{
  "type": "account_unlink"
}

Botão Jogar

O botão de jogo abre um Jogo Instantâneo que estiver associado à sua Página do Facebook. Para personalizar a abertura do jogo, defina a propriedade payload na solicitação que será enviada para o jogo ao iniciar, bem como a propriedade opcional game_metadata.player_id ou game_metadata.context_id. Isso permite que o bot inicie o jogo em um contexto específico contra um jogador ou grupo existente.

Formato do botão

A propriedade payload deve estar serializada em JSON. É desserializada pelo SDK dos Jogos Instantâneos.

Para ver uma lista completa das propriedades do botão, consulte Game Play Button Reference.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

Consulte o evento de webhook de sessão de jogo referente ao evento que será enviado ao bot quando um usuário terminar uma rodada no jogo.

Botão Marcar hora

Este botão permite que você envie um convite de marcação de hora aos usuários. Antes de convidar o usuário para agendar um serviço, exiba um calendário e informe o horário de atendimento na página da sua empresa. Ao clicar no botão, o usuário verá a interface nativa de Marcar hora.

Para conferir a lista completa de propriedades, consulte Booking Button Reference.

Formato do botão

{
  "type": "booking"
}

Boas práticas