Referência do botão URL

O botão URL abre uma página da web no webView do Messenger. Esse botão pode ser usado com modelos do tipo genérico e de botão.

Se o site tiver links de app, o clique no botão abrirá um app nativo. Caso você tenha acabado de fazer a alteração, use o Depurador de Compartilhamento para solicitar uma nova raspagem do site.

Para obter mais informações sobre o uso do botão URL, consulte Botão URL.

Sintaxe do botão URL

SDK de extensões do Messenger: é obrigatório incluir domínio na lista de liberação

Para exibir uma página da web com o SDK das Extensões do Messenger ativado no webView da plataforma, é obrigatório adicionar o domínio (inclusive o subdomínio) à lista de liberação na propriedade whitelisted_domains do perfil do Messenger do seu bot. Isso garantirá que apenas domínios confiáveis tenham acesso aos dados do usuário disponíveis com as funções do SDK.

Consulte a referência de whitelisted_domains para saber mais sobre a inclusão de domínios na lista de liberação.

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

Exemplo de uso de URL

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"Try the URL button!",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com/",
            "title":"URL Button",
            "webview_height_ratio": "full"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Exemplo de resposta de URL

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

Propriedades de URL

Propriedade Tipo Descrição

type

String

Tipo de botão. Precisa ser web_url.

title

String

Título do botão. Limite de 20 caracteres.

url

String

Essa URL é aberta no navegador para celular quando o botão é clicado. Use o protocolo HTTPS se messenger_extensions for verdadeiro.

webview_height_ratio

String

Opcional. Altura do webView. Valores válidos: compact, tall, full. O padrão é full.

messenger_extensions

Booliano

Opcional. Precisa ser true quando estiver usando as Extensões do Messenger.

fallback_url

String

A URL para usar em clientes que não aceitam as Extensões do Messenger. Se não for definido, url será usado como o valor padrão. Só poderá ser especificado se messenger_extensions for verdadeiro.

webview_share_button

String

Opcional. Defina como hide para desabilitar o botão Compartilhar no webView (quando houver informações sensíveis). Isso não afetará nenhum compartilhamento iniciado pelo desenvolvedor usando as extensões.