--- title: "Canais de mensagens no Facebook" slug: "facebook-message-channels" updated: 2026-06-12T10:30:54Z published: 2026-06-12T10:30:54Z canonical: "docs.xtremepush.com/facebook-message-channels" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Canais de mensagens no Facebook Tanto mensagens simples quanto mensagens ricas podem ser enviadas via Facebook Messenger ## Configuração As mensagens do Facebook são construídas usando um modelo de webhook. A configuração tanto para mensagens simples quanto para mensagens ricas é a mesma, veja o [guia rápido de início do Webhooks](/documentation/docs/pt-br/quick-start-webhooks) para a configuração inicial. Para o Facebook, a URL a ser usada (retirada da [documentação da API do Facebook Messenger](https://developers.facebook.com/docs/messenger-platform/send-messages#send_api_basics)) é `https://graph.facebook.com/v2.6/me/messages?access_token=************************`. O **tipo de corpo do Pedido** é sempre *Texto Bruto*, com os parâmetros fornecidos em formato JSON, detalhados nas seções seguintes para mensagens simples e ricas. Por fim, essa API requer um cabeçalho. Clique **em Adicionar cabeçalho** e defina a chave para *Type-Conteúdo* e o valor para *application/json*. ![2228](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/a1c5759-Screenshot_2022-10-19_at_13.03.19(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A15Z&se=2026-11-04T09%3A57%3A15Z&sr=c&sp=r&sig=6xbmIkdI89s3LqFYW3iSSG%2FsBF0EE0UGSryFxAnvIGg%3D) ## ## Canal de mensagens simples No exemplo abaixo, você pode ver como um canal simples do Facebook Messenger é construído usando um modelo de webhook. Os parâmetros do corpo da solicitação para este endpoint Messages são: - `recipient`: Nome do Objeto JSON contendo parâmetros para o usuário para o qual a mensagem deve ser enviada - `id`: o ID do Facebook Messenger do usuário. Isso é extraído do perfil do seu usuário via a sintaxe de personalização `{{fb_messenger_id}}` - `message`: Nome do Objeto JSON contendo parâmetros para o conteúdo da mensagem - `text`: O texto da mensagem a ser enviada ```json {  "recipient": {    "id":"{{fb_messenger_id}}"  },  "message": {    "text": "Your Message here"  } } ``` O estilo simples da mensagem aparece como uma notificação na tela de bloqueio do celular e aparece no aplicativo Messenger no celular ou na web, conforme mostrado abaixo: ![747](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/2f9918b-d63d75d-FB-message-both(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A15Z&se=2026-11-04T09%3A57%3A15Z&sr=c&sp=r&sig=6xbmIkdI89s3LqFYW3iSSG%2FsBF0EE0UGSryFxAnvIGg%3D) Mensagem simples no Facebook ## Canal de mensagens ricas Esse estilo de mensagem rico terá elementos que aparecem como no exemplo abaixo no Facebook Messenger. Ele usa um modelo chamado Facebook Messenger de [modelo genérico](https://developers.facebook.com/docs/messenger-platform/send-messages/template/generic): ![750](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/1901cf0-FB-Messenger-on-iphone-generic-template-message(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A15Z&se=2026-11-04T09%3A57%3A15Z&sr=c&sp=r&sig=6xbmIkdI89s3LqFYW3iSSG%2FsBF0EE0UGSryFxAnvIGg%3D) Mensagem rica no Facebook. Existem vários tipos adicionais de mensagens enriquecidos que você pode criar, que estão detalhados nos documentos do Facebook Messenger e incluem: - [Modelo de Lista](https://developers.facebook.com/docs/messenger-platform/send-messages/template/list) - [Modelo de Mídia](https://developers.facebook.com/docs/messenger-platform/send-messages/template/media) - [Modelo de Recibos](https://developers.facebook.com/docs/messenger-platform/send-messages/template/receipt) - [Modelos de Companhias Aéreas](https://developers.facebook.com/docs/messenger-platform/send-messages/template/airline) O modelo de lista é ótimo para atualizações de notícias para editoras, o modelo de mídia permite enviar vídeos e outros conteúdos ricos, o modelo de recibo é ótimo para enviar recibos de comércio eletrônico e os modelos de companhias aéreas cobrem casos de uso como cartões de embarque, etc. Os parâmetros do corpo da solicitação para o endpoint desta mensagem incluem: - `recipient`: Nome do Objeto JSON contendo parâmetros para o usuário para o qual a mensagem deve ser enviada - `id`: o ID do Facebook Messenger do usuário. Isso é extraído do perfil do seu usuário via a sintaxe de personalização `{{fb_messenger_id}}` - `message`: Nome do Objeto JSON contendo parâmetros para o conteúdo da mensagem - `attachment`: Objeto JSON para mensagem com conteúdo rico anexado - `type`: tipo de anexo "template" para este exemplo - `payload`: Objeto JSON para a carga útil da mensagem - `template_type`: o tipo de modelo usado é "genérico" para este exemplo. Para saber mais sobre o [modelo genérico do Facebook Messenger, veja a documentação](https://developers.facebook.com/docs/messenger-platform/send-messages/template/generic) - `elements`: Array JSON com objetos para elementos individuais da mensagem - `image_url`: a URL da imagem - `title`: título da mensagem aparece abaixo da imagem - `subtitle`: o subtítulo que aparece abaixo do título - `buttons`: os botões CTA que aparecem abaixo da legenda > [!NOTE] > Parâmetros de mensagens ricas em FB > > Parâmetros podem ter múltiplos elementos. Há um exemplo de JSON para uma mensagem rica com dois elementos mais abaixo neste artigo). ```json {  "recipient": {    "id": "{{fb_messenger_id}}"  },  "message": {    "attachment": {      "type": "template",      "payload": {        "template_type":"generic",        "elements": [          {            "title": "YOUR TITLE HERE",            "image_url": "YOUR IMAGE URL HERE",            "subtitle": "YOUR SUBTITLE HERE",            "buttons": [              {                "type": "web_url",                "url": "YOUR LINK HERE",                "title": "BUTTON TEXT HERE"              }            ]          },          ...... ADDITIONAL ELEMENTS        ]      }    }  } } ``` Você pode usar uma mensagem de exemplo abaixo baseada no conteúdo do [blog do xtremepush](https://xtremepush.com/blog-2/) para testar rapidamente esse estilo de mensagem. ```json {  recipient: {    id: recipientId  },    "message": {    "attachment": {      "type": "template",      "payload": {        "template_type": "generic",        "elements": [          {            "title": "Geofencing vs iBeacons",            "image_url": "https://d2duw1tbgzwwah.cloudfront.net/wp-content/uploads/2017/10/geo-vs-beacons-750x500.jpg?resize=720%2C346&ssl=1",            "subtitle": "Which best suits your Business?",            "buttons": [              {                "type":"web_url",                "url":"https://xtremepush.com/xtremepush-geofencing-ibeacons/",                "title":"Read More"              }            ]          },          {            "title": "GDPR – The Practicalities of a New Reality",            "image_url": "https://d2duw1tbgzwwah.cloudfront.net/wp-content/uploads/2017/05/GDPR-Practicalities-NEWS-750x423.png?resize=1250%2C600&ssl=1",            "subtitle": "There are now about 380 days until GDPR is ‘the new reality",            "buttons": [              {                "type":"web_url",                "url":"https://xtremepush.com/gdpr-get-gdpr-compliant/",                "title":"Read More"              }            ]          }        ]      }    }  } } ``` O estilo de mensagem rica aparece no aplicativo de mensagens no celular ou web, conforme mostrado abaixo (mensagem com imagens e CTA abaixo são do exemplo acima). ![750](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/9eff04d-FB-Messenger-on-iphone(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A15Z&se=2026-11-04T09%3A57%3A15Z&sr=c&sp=r&sig=6xbmIkdI89s3LqFYW3iSSG%2FsBF0EE0UGSryFxAnvIGg%3D) Visualização móvel de mensagens ricas no Facebook. ![1327](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/b6814ca-FB-Messenger_on_Facebook(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A15Z&se=2026-11-04T09%3A57%3A15Z&sr=c&sp=r&sig=6xbmIkdI89s3LqFYW3iSSG%2FsBF0EE0UGSryFxAnvIGg%3D) Visualização web com mensagens ricas no Facebook. > [!TIP] > Modelos de webhook do Facebook > > Como boa prática, quando seu webhook estiver recebendo respostas na faixa de código de resposta de 20x e funcionando como esperado, recomenda-se copiar seu conteúdo (todas as configurações configuradas, exceto o texto da mensagem) e salvá-lo como [modelo](/documentation/docs/pt-br/templates). Isso permitirá que você selecione rapidamente na aba de webhook no construtor de campanhas.