Este guia mostra como configurar o canal Facebook no Sendbot, backend e Studio, para receber e responder mensagens via DMs e comentários.

Pré-requisitos

  • Um app no Meta Developers com acesso ao Messenger
  • Um Access Token válido com permissões da página
  • O Page ID da página do Facebook que vai receber as mensagens

Configuração do backend (API)

In your API environment, both production and staging, configure:
Notas importantes
  • The Meta App Secret is stored encrypted with the workspace credential and is used to validate webhook signatures for that credential.
  • NEXT_PUBLIC_SENDBOT_API_URL must point to your public API so Studio can generate the webhook URL.
  • In a local environment, use a public URL such as https://<your-ngrok>.ngrok.io and make sure HTTPS is enabled.

Configuração do webhook na Meta

In Meta Developers:
  1. Open Webhooks and add an endpoint for Page.
  2. Use the webhook URL generated by Studio:
  1. Generate the Verification Token in Studio and provide it in Meta to validate the signature.
  2. Select message events to receive DMs.
  3. For comments, also enable the Comments events on the same webhook.

Configuração no Studio

  1. Go to Share on the bot -> Facebook.
  2. Create the credentials:
    • Access Token
    • Meta App Secret
    • Page ID
  3. Click Generate token and copy the Verification Token.
  4. Configure the webhook in Meta with the URL and token.
  5. Enable Enable Facebook integration and publish the bot.

Respostas em comentários

In Studio, you can enable automatic replies to comments:
  1. Open Share on the bot -> Facebook.
  2. In Comments, enable Enable comment replies.
  3. Choose the Reply mode:
    • Public reply: replies on the comment
    • DM only: sends a DM to the user
    • Public + DM: replies on the comment and sends a DM
  4. Optional: define the Start condition (comments) to filter which comments start the bot.
  5. Publish the bot.

Checklist de produção

  • appSecret configured in the backend
  • Public API URL configured in Studio
  • Webhook validated in Meta using the token generated by Studio
  • Credentials saved and integration enabled on the bot
  • Comments events enabled on the webhook if you use comment replies

Solução rápida de problemas

  • Webhook 401: invalid signature or incorrect token
  • Webhook 500: missing appSecret or unsigned request body
  • No reply: make sure the Page is connected to the Meta app and the correct events are enabled