# Facebook Messenger

## Como conectar uma página do Facebook

Se você já tiver uma página comercial do Facebook, pode conectar um bot a ela.

{% hint style="warning" %}

#### **IMPORTANTE!**

Certifique-se de criar uma **Página**, e não um Grupo. Chatbots no Facebook só podem ser conectados a Páginas.
{% endhint %}

{% hint style="danger" %}
Um bot só pode ser conectado pelo proprietário da página ou por um administrador.
{% endhint %}

Primeiro, crie uma página Comercial do Facebook.

<div data-with-frame="true"><figure><img src="/files/330d6c8d5cde07ecc3e3d4658b666b17e7491dfb" alt=""><figcaption></figcaption></figure></div>

Para conectar o Facebook ao MaviBot, vá para a seção "Mensageiros" e selecione Facebook.

<div data-with-frame="true"><figure><img src="/files/0acfd39ea92f95590686c57ab12f14333933c8f9" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/5f3a897264129e3d07dedc8daa263237b9b36dd5" alt="" width="375"><figcaption></figcaption></figure></div>

Faça login para autorizar o acesso à sua conta na janela pop-up. Após a autorização, você verá uma lista das suas páginas comerciais disponíveis para conexão. Selecione a que deseja usar.

{% hint style="info" %}
Talvez seja oferecido a você conectar suas **contas do Instagram Business** também, mas isso é opcional.
{% endhint %}

Em seguida, selecione a página à qual deseja conectar o bot. Depois, escolha as permissões para o bot. Certifique-se de ativar todas as chaves.

<div data-with-frame="true"><figure><img src="/files/18309fb61d03c0d15785d9bef3188bccdc644969" alt=""><figcaption></figcaption></figure></div>

Se o processo for bem-sucedido, você verá a seguinte janela.

{% hint style="warning" %}
As mensagens devem estar ativadas para a página.
{% endhint %}

Você verá um botão padrão "Iniciar" depois de entrar no grupo.

Não se esqueça de incluir esta palavra nas condições do bloco de início.

A mensagem de boas-vindas que o usuário vê antes de clicar no botão "Iniciar" é configurada nas definições da página do Facebook.

### O que fazer se a página necessária não estiver na lista

Se você não vir o grupo de que precisa na lista, provavelmente significa que o criador não tem permissões para esse grupo. Você precisa concedê-las.

**Para fazer isso:**

Saia do sistema usando o botão no canto superior direito.

Clique em "Entrar com o Facebook".

<div data-with-frame="true"><figure><img src="/files/6f0a57f137504ae24fabbccd286eeee113c9473c" alt="" width="563"><figcaption></figcaption></figure></div>

Clique **"Editar configurações"**.

Escolha a página que deseja e siga todas as etapas descritas no início do artigo.

## Como criar transmissões no Facebook

Isso se aplica a qualquer mensagem que você enviar: por meio de chatbots, transmissões em massa ou mensagens enviadas manualmente.

Quando um usuário se inscreve em um chatbot ou inicia uma conversa com a página da empresa, você tem uma janela de 24 horas a partir desse momento para enviar ao usuário qualquer mensagem, inclusive promocionais.

1. Se o usuário não responder em até 24 horas, o Facebook permite que você envie mais uma mensagem. Essa mensagem pode incluir um botão e uma oferta forte para chamar a atenção do assinante e incentivar uma resposta.
2. Se o usuário responder dentro da janela de 24 horas, uma nova janela de 24 horas se abre.
   &#x20;Isso acontece toda vez que ele responde a uma mensagem do chatbot.

Essa regra tem algumas exceções.
&#x20;Mais detalhes: [https://developers.facebook.com/docs/messenger-platform/policy/policy-overview\ <br>](https://developers.facebook.com/docs/messenger-platform/policy/policy-overview)Uma delas é **tags de mensagem** — um tipo de mensagem permitido que pode ser enviado mesmo após o término da janela de 24 horas.\
\
Existem 16 tipos de tags de mensagem. Escolhemos usar **confirmed\_event\_update** – "Lembrete de evento." No futuro, podemos adicionar a opção de escolher qual tipo de mensagem você deseja enviar.

{% hint style="danger" %}
Um**Após 24 horas desde a última interação do usuário**, você só está autorizado a enviar mensagens relacionadas a lembretes de eventos — como confirmar reservas futuras, notificar sobre mudanças de agenda ou lembrar os usuários de compromissos ou eventos para os quais se inscreveram.

**Enviar qualquer tipo de conteúdo promocional após a janela de 24 horas é estritamente proibido.**
\
Violar essa regra pode levar ao bloqueio da sua página do Facebook.
{% endhint %}

\
Uma vantagem dessa solução é que as transmissões não exigem moderação.
&#x20;Ela também oferece uma forma de contornar a regra 24+1.

## Como trabalhar com o Facebook Pixel

{% hint style="success" %}
Para instalar o Pixel em nossa mini landing page, você precisa vincular seu próprio domínio a ela.
{% endhint %}

O Facebook exige o uso de domínios verificados. Para instruções detalhadas sobre a instalação do Pixel, leia AQUI.

## Como criar um carrossel

<div data-with-frame="true"><figure><img src="/files/608fc0cc0cb5672a8c3d1622f2ced2e68463fbf4" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Um carrossel pode conter de 2 a 10 cards (slides).
{% endhint %}

Vamos considerar um exemplo de um carrossel com 3 cards. Para criar os cards, você precisa inserir o seguinte no campo "Calculadora".

p = \[
\
{"title": "TÍTULO", "description": "DESCRIÇÃO DO CARD 1", "image": "LINK PARA A IMAGEM 1", "buttons": \[{"text": "TEXTO DO BOTÃO 1"}]},
\
{"title": "TÍTULO", "description": "DESCRIÇÃO DO CARD 2", "image": "LINK PARA A IMAGEM 2", "buttons": \[{"text": "TEXTO DO BOTÃO 2"}]},
\
{"title": "TÍTULO", "description": "DESCRIÇÃO DO CARD 3", "image": "LINK PARA A IMAGEM 3", "buttons": \[{"text": "TEXTO DO BOTÃO 3"}]}
\
]

r = send\_carousel(p, '')

<div data-with-frame="true"><figure><img src="/files/792fae0c3435ba8cf2d9cd0bb105844e6bd065ec" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Observe: a linha **r = send\_carousel(p, '')** deve ser inserida em uma nova linha no campo de entrada da calculadora.
{% endhint %}

{% hint style="danger" %} <mark style="color:vermelho;">**ATENÇÃO!**</mark>

Ao criar uma descrição de card de carrossel como

\
{"**title**": "TÍTULO", "**description**": "DESCRIÇÃO DO CARD 1", "**image**": "LINK PARA A IMAGEM 1", "buttons":\[{"text":"TEXTO DO BOTÃO 1"}]} <br>

é importante **preencher** seja o **title** <mark style="color:vermelho;">**e**</mark> **parâmetro de descrição ou de imagem**.
{% endhint %}

Primeiro, atribua uma matriz com título, descrição, imagem e botões à variável p (você pode nomear a variável de forma diferente). Depois, use-a no método send\_carousel(p, '').

Você também pode usar a tabela para simplesmente inserir os títulos, links etc. necessários e, depois, apenas copiar o resultado para o seu bloco.

No campo "Resposta", deixe #{None}.

<div data-with-frame="true"><figure><img src="/files/fdfeb1cb5a853cc0a472ad17cd2422d909238f6c" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Você pode inserir URLs nos botões dos cards do carrossel. Quando um usuário clicar em um botão, ele será redirecionado para o link.
{% endhint %}

Para adicionar um link a um botão em um card, inclua-o na seguinte matriz:

p = \[
{
"title": "title",
"description": "DESCRIÇÃO DO CARD 1",
"image": "LINK PARA A IMAGEM 1",
"buttons": \[
{
"text": "TEXTO DO BOTÃO 1",
"url": "LINK PARA O BOTÃO"
}
]
}
]

{% hint style="info" %}
Um parâmetro opcional adicional **payload** foi adicionado aos botões dos cards do carrossel.
&#x20;Esse parâmetro não ficará visível para o usuário, mas permite rastrear e analisar a escolha do usuário.
{% endhint %}

Como muitas vezes é necessário ter cards de carrossel com o mesmo texto de botão, um parâmetro adicional chamado **payload** foi adicionado.

Esse parâmetro não ficará visível para o usuário, mas permite analisar sua escolha:

<div data-with-frame="true"><figure><img src="/files/f4ea360ecb52a6725f19d1f22ff88853d752b883" alt="" width="563"><figcaption></figcaption></figure></div>

Preste atenção ao uso correto:\
p = \[
{
"title": "title",
"description": "DESCRIÇÃO DO CARD 1",
"image": "LINK PARA A IMAGEM 1",
"buttons":\[{"text": "TEXTO DO BOTÃO 1", "payload": "1"}]
},
{
"title": "title",
"description": "DESCRIÇÃO DO CARD 2",
"image": "LINK PARA A IMAGEM 2",
"buttons": \[{"text": "TEXTO DO BOTÃO 1", "payload": "2"}]
}, {
"title": "title",
"description": "DESCRIÇÃO DO CARD 3",
"image": "LINK PARA A IMAGEM 3",
"buttons": \[{"text":"TEXTODOBOTÃO 1"}]
}
]

O parâmetro payload é opcional e pode ser omitido, como mostrado na figura do botão 3.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/chatbot/mensageiros/facebook-messenger.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.