Configurando o Facebook Messenger para o 3CX
Introdução
A integração com o Facebook permite que seus atendentes respondam às mensagens da sua Página do Facebook diretamente do 3CX, sem precisar fazer login no Facebook Messenger. As mensagens podem ser encaminhadas para uma fila de chamadas, um grupo de toque ou um ramal específico. Os atendentes podem assumir o atendimento de uma mensagem ou transferi-la para outro atendente ou grupo.
É necessária uma conta verificada do Facebook Business.
O guia a seguir segue a atualização de 2026 do fluxo de criação de Aplicativos da Meta, com opções de permissão simplificadas.
Passo 1: Inicie a Configuração no Seu PABX 3CX
- Acesse Admin > Voz e chat, selecione “Adicionar mensagens” e, em seguida, selecione “Adicionar Facebook”.
- Defina o nome como desejar.
- Se você for um Proprietário do Sistema ou um Administrador do Sistema, poderá disponibilizar a integração para todo o sistema ou apenas para o grupo.
- Copie a URL do Webhook do 3CX para um editor de texto e mantenha-a à mão.
Etapa 2: Criar um Aplicativo no Facebook
- Acesse https://developers.facebook.com e clique em Entrar no canto superior direito.
- Acesse Meus Aplicativos.
- Clique em Criar Aplicativo.
- Dê um nome de exibição ao seu aplicativo, insira um e-mail de contato e clique em Avançar.
- Selecione a opção Mensagens Empresariais.
- Selecione a opção “Messenger da Meta” e, em seguida, clique em Avançar.
- Escolha o portfólio de negócios ao qual você deseja conectar este aplicativo; você pode optar por adicioná-lo mais tarde.
- Caso a Meta tenha outros requisitos de Publicação que você precise cumprir antes de prosseguir, eles serão listados agora.
- Clique em Avançar.
- Antes de criar o Aplicativo, certifique-se de que o nome do Aplicativo, o e-mail de contato do Aplicativo e outros detalhes estejam corretos; clique em Criar aplicativo.
- Confirme sua senha, se solicitado.
- A próxima tela é o Painel do aplicativo:
- Isso exibirá uma lista das tarefas que precisam ser concluídas antes da publicação.
- Você deve se certificar de que todas as tarefas necessárias estejam concluídas.
- Caso você saia do portal do Facebook Developers, poderá retornar a este ponto por meio do item de menu “Casos de Uso” (ícone de lápis).
- Selecione a opção Personalizar:
- Selecione Configurações da API do Messenger.
- Expanda Configurar webhooks:
- Insira o Webhook que você salvou na Etapa 1 no campo URL de Retorno de Chamada.
- Digite a sequência longa após o último “/” (por exemplo, aabbccddeeff000000001122334455) no final do webhook, no campo “Verificar token”.
- Role a página para baixo e preencha os campos obrigatórios do Webhook utilizando a versão mais recente da API disponível:
- mensagens
- entregas_de_mensagens
- informações_sobre_o_cliente_para_mensagens
- o texto da mensagem diz
- message_echoes
- Clique em Verificar e salvar.
- Expanda Gerar tokens de acesso:
- Clique em “Adicionar uma página”:
- Siga o processo de autenticação e escolha a página da empresa que você deseja adicionar.
- Depois que a página for adicionada, faça uma observação do ID da página do Facebook.
- Selecione a opção de menu “Adicionar assinaturas de webhook” e adicione:
- mensagens
- entregas_de_mensagens
- mensagens_antes_da_finalização_da_compra
- informações_sobre_mensagens_para_clientes
- o texto da mensagem diz
- message_echoes
- Clique em Gerar para obter um token de API e salve-o.
- Se você voltar a esta página, basta passar o mouse sobre a seção “Assinaturas” para ver a opção “Editar”.
- Por enquanto, NÃO prossiga com Revisão Completa do Aplicativo.
Etapa 3: Continue a Configuração no 3CX
- Acesse Admin > Usuários e crie um usuário temporário de teste que será utilizado no processo de análise da inscrição na Etapa 4 abaixo.
- Cole seu ID da Página e Token de Acesso obtidos na Etapa 2.
- Certifique-se de que o encaminhamento de mensagens esteja configurado para o seu novo usuário temporário de teste.
Etapa 4: Modo de Desenvolvimento
Seu aplicativo já está configurado para funcionar com o 3CX e você pode tentar enviar uma mensagem para sua página do Facebook.
Nesta fase, seu aplicativo está no modo Desenvolvimento, o que significa que você só pode interagir com:
- usuários que têm permissão para gerenciar sua página
- usuários que foram adicionados como testadores.
Você pode adicionar mais usuários de teste por meio do Painel do Aplicativo > Funções > Funções do aplicativo > Adicionar Pessoas.
No modo Desenvolvimento, apenas o ID numérico do usuário do Facebook ficará visível no 3CX. Para que o nome completo do usuário do Facebook fique visível, é necessário alternar para o modo “Live”.
Para mudar para o modo “Live”, é necessário solicitar permissões adicionais e realizar uma análise do aplicativo — veja os detalhes na etapa “Análise do Aplicativo”.
Etapa 5: Análise do Aplicativo
- No Painel de Aplicativos Meta, acesse Configurações do Aplicativo > Básico.
- Preencha os dados necessários:
- URL da política de privacidade
- URL para exclusão de dados do usuário (pode ser a mesma URL da Política de Privacidade)
- Categoria (Escolha “Mensagens” ou “Negócios”)
- Carregar um ícone de aplicativo
- Dependendo da sua região e do seu ramo de atividade, talvez seja necessário preencher a seção sobre o GDPR abaixo das configurações principais.
- Selecione + Adicionar plataforma na parte inferior da página.
- Digite a URL do seu Site e clique em Avançar.
- Insira a URL do seu PABX 3CX, por exemplo, https://mypbx.3cx-example.com.
- Clique em Salvar Alterações.
- No menu lateral, clique em Casos de uso (ícone de lápis).
- Clique em Personalizar e adicione a permissão de acesso ao Perfil de Usuário de Ativos Empresariais.
- Clique em Configurações da API do Messenger.
- Clique em Personalizar caso de uso.
- Em Permissões e recursos, adicione Acesso ao Perfil de Usuário de Ativos Empresariais.
- Clique no botão Solicitar permissão:
- Selecione as opções pages_show_list e pages_manage_metadata; clique no botão Solicitar permissão. Isso o levará à página Enviar para Análise do Aplicativo.
- Abra o PABX 3CX e faça login como (ou assuma a identidade de) usuário de teste; acesse a seção “Chat” no Cliente Web 3CX.
- Abra sua página do Facebook conectada usando uma conta com direitos de teste para o aplicativo.
- Coloque as duas janelas lado a lado e inicie uma gravação de tela; isso é necessário para a análise e verificação do Facebook.
- Converse um pouco por mensagens e salve o vídeo.
- Volte à página Enviar para Análise do Aplicativo do Facebook e clique em Avançar.
- Conclua todas as etapas, preenchendo todos os detalhes, até chegar às Instruções para revisores. É necessário ter uma conta Verificada para prosseguir.
- Na página Instruções para revisores:
- Confirme a sua URL do Site.
- Preencha os campos das perguntas da seguinte forma:
- (instruções-web-2) Forneça instruções sobre como acessar o aplicativo para que possamos concluir nossa análise.
Este aplicativo do Facebook é usado para integrar um Sistema Telefônico 3CX (https://3cx.com) aos chats do Facebook Messenger. Cada cliente 3CX tem sua própria instância do 3CX e, portanto, precisará criar seu próprio aplicativo para integrar uma Página do Facebook. pages_messaging é necessário para receber e enviar mensagens iniciadas por um visitante de uma Página do Facebook.
Etapa 1. Faça login no 3CX WebClient com as seguintes credenciais:
- URL do cliente Web do PABX: https://example-PABX.3cx.com/
Etapa 2. Escreva e envie uma mensagem de teste na Página do Facebook.
Etapa 3. Receba e responda à mensagem no seu Cliente Web 3CX.
- (accesscode-web-1) Caso seja necessário efetuar um pagamento ou se tornar membro para acessar todas as funcionalidades deste aplicativo:
- Ramal: ________
- Senha: ________
- (documentos-web-1) Inclua a documentação de apoio:
- Envie o seu vídeo gravado anteriormente.
- Clique em Avançar.
- Assim que todas as seções estiverem preenchidas, você poderá enviar para revisão.
O aplicativo pode ser publicado por meio do botão “Publicar” no menu lateral. Se você publicar antes da aprovação, poderá receber mensagens em geral, mas não o nome do remetente nem outros detalhes.
Assim que sua inscrição for aprovada, você receberá mensagens de usuários do Facebook com o nome do remetente. Certifique-se de excluir o usuário temporário de teste criado para o processo de verificação do aplicativo e atualize o caminho para encaminhar as mensagens para o destino desejado.
Veja Também
- Como configurar o Chat ao Vivo
- Como configurar o WhatsApp
- Como configurar SMS/MMS
- Como Gerenciar Consultas de Clientes
Última Atualização
Este documento foi atualizado pela última vez em 8 de setembro de 2026
Copyright © 2025