Criando um App

Passo a passo de criação e configuração do app do Facebook para o Chatfood.

Vídeo com o passo a passo: https://youtu.be/HmfCL1Kjf6Y

Antes de começar, você precisa de um perfil de desenvolvedor.

1. Criar o aplicativo

1. Acesse:
   • https://developers.facebook.com/apps/
2. Clique em Criar Aplicativo.
3. Preencha:
   • Nome do aplicativo
   • E-mail de contato (normalmente já vem preenchido com o do(a) dono(a) do perfil)
4. Clique em Avançar.

---

2. Selecionar caso de uso

1. Na tela Casos de Uso, primeiro clique no filtro:
   • Tudo
2. Então selecione:
   • Interagir com clientes no Messenger from Meta
   • Gerenciador de páginas
3. Clique em Avançar.

---

3. Empresa

1. Em Empresa, selecione:
   • Ainda não quero me conectar a um portfólio empresarial
2. Clique em Avançar.

---

4. Revisão (antes de criar)

1. Clique em Avançar (não deve aparecer “Requisitos”).
2. Em Visão Geral, confirme que o único caso de uso selecionado é:
   • Interagir com clientes no Messenger from Meta
3. Clique em Criar Aplicativo.

---

5. Configurar webhook do Messenger

Após a criação, você será redirecionado para o painel do aplicativo.

1. Clique em Caso de Uso e localize:
   • Interagir com clientes no Messenger from Meta
2. Clique em Personalizar.
3. Em Configurações da API do Messenger from Meta, clique em:
   • Configure Webhooks
4. Preencha:

   • URL de Callback:

     https://bot.chatfood.app/facebook/message/webhook/ID_DO_APLICATIVO

     Substitua ID_DO_APLICATIVO pelo ID do app criado.

   • Token de Verificação: use o token de verificação informado pela equipe do Chatfood.

5. Clique em Verificar e Salvar.

---

6. Selecionar eventos do webhook

1. Depois de salvar (a página vai recarregar), acesse novamente:

   • Configure Webhooks

2. Clique na seta para expandir os eventos.

3. Marque:

   feed
   messages
   messaging_postbacks
   message_reads
   message_deliveries
   messaging_referrals

Não é necessário salvar novamente após marcar esses eventos.

---

7. Configurar Facebook Login for Business

1. No menu lateral, acesse:

   • Login do Facebook para Empresas

2. Clique em Configurações.

3. Ajuste:

   • Entrar com o SDK do JavaScript:

     Sim

   • Domínios permitidos para o SDK do JavaScript:

     https://admin.chatfood.app/

4. Clique em Salvar.

---

8. Configurações básicas do aplicativo

1. No menu lateral, acesse:

   • Configurações
   • Básico

2. Preencha:

   • Política de Privacidade:

     https://admin.chatfood.app/terms/privacy

   • Termos de Serviço:

     https://admin.chatfood.app/terms/policy

3. Clique em Salvar Alterações.

---

9. Configurar permissões nos casos de uso

Messenger from Meta

Ative as seguintes permissões:

business_management
email
pages_manage_metadata
pages_messaging
pages_read_engagement
pages_show_list
pages_utility_messaging
public_profile

Gerenciador de páginas

Ative as seguintes permissões:

business_management
email
pages_manage_engagement
pages_manage_metadata
pages_read_engagement
pages_read_user_content
pages_show_list
public_profile

---

10. Publicar o aplicativo

1. Retorne ao painel principal do aplicativo.

2. Clique em:

   Publicar

3. Confirme a publicação.

---

11. Adicionar o App no Chatfood

1. Acesse Configurações > Contas e Usuários > Apps.

2. Clique em:

   Adicionar App

3. Preencha os seguintes campos:

   • Nome
   • App ID
   • App Secret

4. Clique em Configurações Avançadas e selecione as permissões abaixo:

   email
   business_management
   pages_read_engagement
   pages_read_user_content
   pages_manage_engagement
   pages_utility_messaging

5. Clique em Adicionar para finalizar.

Cuidado

Se o Facebook não mostrar a chave secreta (App Secret), veja Problema ao exibir a chave secreta.

---

Checklist final

• ✅ Aplicativo criado
• ✅ Caso de uso “Interagir com clientes no Messenger from Meta” selecionado
• ✅ Webhook configurado (URL de callback e token de verificação)
• ✅ Eventos do webhook marcados
• ✅ Facebook Login configurado (domínio https://admin.chatfood.app/)
• ✅ Política de Privacidade e Termos de Serviço preenchidos
• ✅ Aplicativo publicado