Configurar canal Facebook

Um canal Facebook permite que sua equipe receba e responda mensagens enviadas por clientes através da sua página do Facebook — diretamente no Virtual-Call UC Client. As mensagens recebidas pelo Facebook Messenger aparecem no UC Client com os demais canais de mensagens, e os agentes podem respondê-las em tempo real. Este artigo descreve como configurar um canal Facebook no Cloud PABX.

Pré-requisitos

• Conta Meta Developer: Uma conta registrada no portal Meta for Developers.
• Portfólio de Negócios (Meta Business Suite): Uma conta no Meta Business Suite vinculada a uma empresa verificada.
• Página do Facebook Empresarial: Uma Página do Facebook publicada e associada ao seu Portfólio de Negócios.
• Nome de domínio: O nome de domínio do seu Cloud PABX não deve conter caracteres de sublinhado (_), pois isso pode causar falhas na autenticação do webhook.
• Certificado de domínio: Se o seu PABX utiliza um domínio personalizado (não o domínio padrão do provedor), um certificado de domínio válido deve estar instalado.

Limitações

Visão geral da configuração

A configuração de um canal Facebook envolve quatro etapas:

1. Criar um aplicativo Meta no portal Meta for Developers
2. Configurar o aplicativo Meta e obter as credenciais de autenticação
3. Criar o canal Facebook no PABX
4. Configurar o webhook no aplicativo Meta

Etapa 1: Criar um aplicativo Meta

1. Faça login no portal Meta for Developers.
2. Acesse Meus Apps e clique em Criar aplicativo.
3. Selecione o caso de uso Outro e depois o tipo de aplicativo Negócios.
4. Insira um nome para o aplicativo, seu e-mail de contato e selecione seu portfólio de Negócios.
5. Clique em Criar aplicativo para concluir.

Etapa 2: Configurar o aplicativo Meta

Adicione o produto Messenger ao seu aplicativo e obtenha as credenciais necessárias para a configuração no PABX.

1. No painel do aplicativo, localize Messenger na lista de produtos e clique em Configurar.
2. Na seção Gerar tokens de acesso, clique em Conectar ao lado da Página do Facebook desejada. Siga as instruções para conceder as permissões necessárias.
3. Após conectar a página, clique em Gerar para criar um token de acesso. Copie este token — você vai precisar dele na Etapa 3.
4. Anote os seguintes valores do portal Meta for Developers:
   • ID da página: Exibido na seção Generate access tokens, ao lado da sua página conectada.
   • Nome da página: O nome da sua Página do Facebook conectada.
   • App senha: Em Configurações do aplicativo > Básico.

Etapa 3: Criar o canal Facebook no PABX

1. Faça login no portal administrativo do Cloud PABX.
2. Acesse Mensagens > Canal.
3. Clique em Adicionar e selecione Facebook Messenger.
4. Configure a aba Autenticação:
   • Nome: Um nome descritivo (ex.: “Facebook Suporte” ou “Facebook Vendas”).
   • Webhook URL: Gerada automaticamente. Copie-a — você vai precisar na Etapa 4.
   • Verificar token: Gerado automaticamente. Copie-o — você vai precisar na Etapa 4.
   • Token de acesso: Cole o token de acesso da Etapa 2.
   • App senha: Cole o App Secret da Etapa 2.
   • ID da página: Insira o Page ID da Etapa 2.
   • Nome da página: Insira o Page Name da Etapa 2.

5. Configure a aba Configurações de Mensagens:
   • Destino para mensagens recebidas: Escolha para onde as mensagens Facebook recebidas são encaminhadas:
     • Extensão: As mensagens vão diretamente para um ramal específico.
     • Fila de mensagens: As mensagens vão para uma fila onde vários agentes podem atendê-las.
   • Extensões permitidas para criar sessões de mensagens: Selecione quais ramais podem enviar mensagens por este canal.
   • Fechar sessão automaticamente: Ative esta opção e defina um tempo limite em dias para fechar automaticamente sessões inativas.
   • Permitir a criação de sessões ativas duplicadas: Se um novo agente pode criar uma sessão quando já existe uma sessão ativa com o mesmo contato.
6. Clique em Salvar.

Etapa 4: Configurar o Webhook no aplicativo Meta

Para que o PABX possa receber mensagens do Facebook, você precisa configurar um webhook e inscrever sua página nos eventos de mensagens:

1. Faça login no portal Meta for Developers e acesse Meus Apps.
2. Abra seu aplicativo e navegue até Messenger > Configurações da API do Messenger.
3. Na seção Configure webhooks:
   • Cole a Webhook URL (Callback URL) que você copiou do PABX na Etapa 3.
   • Cole o Verificar token que você copiou do PABX na Etapa 3.
   • Clique em Verificar e salvar.
4. Na seção Gerenciar campos de webhook, assine o campo mensagens.
5. Na seção Gerar tokens de acesso, clique em Adicionar assinaturas para a sua página conectada e assine mensagens.

Resultado

Após a configuração bem-sucedida, o canal Facebook aparece na lista de canais em Mensagens > Canal com um ícone de status verde. O PABX registra automaticamente o número de mensagens enviadas e recebidas.

Notas importantes

• Somente entrada: O canal Facebook não suporta envio de mensagens. Os agentes só podem responder conversas iniciadas por clientes. Para contatar clientes proativamente, utilize o canal WhatsApp ou SMS.
• Validade do acesso do token: O token de acesso gerado no portal Meta for Developers é de longa duração. No entanto, pode expirar se as permissões do aplicativo mudarem ou se a Página do Facebook for desconectada. Monitore o status do canal e gere um novo token se necessário.
• Verificação da Empresa: A Meta pode exigir que sua empresa seja verificada antes que determinados recursos do Messenger fiquem disponíveis. Conclua o processo de verificação na Meta Business Suite.
• Tamanho de arquivo: Mensagens multimídia são limitadas a 25 MB. Os arquivos são retidos por 72 horas.
• Acesso IP para multimídia: Se você configurou regras de segurança de acesso por IP, certifique-se de que o acesso dos servidores da Meta esteja permitido — caso contrário, os arquivos de multimídia não poderão ser entregues.