Configurando canais WhatsApp

1. Visão Geral

A Solcon permite integrar sua Conta Comercial do WhatsApp para centralizar conversas e automatizar atendimentos.
A plataforma suporta três provedores de API oficiais:

• WhatsApp Cloud API

• WAHA - WhatsApp HTTP API - Integração WhatsApp self-hosted

Este manual utiliza a WhatsApp Cloud API como exemplo, mas inclui orientações para todos os provedores.

2. Configuração via WhatsApp Cloud API

Pré-requisitos

Antes de iniciar, certifique-se de possuir:

• Conta de desenvolvedor Meta ativa;

• Portfólio de negócios configurado no Meta Business;

• Número de telefone válido e disponível para uso no WhatsApp Business;

• Permissão administrativa na Solcon;

Conceito da API do WhatsApp Cloud

A API do WhatsApp Cloud é fornecida diretamente pela Meta e executada em sua infraestrutura de nuvem. Com ela, não é necessário contratar provedores terceirizados para hospedar a API do WhatsApp Business.

Essa abordagem reduz custos, simplifica a arquitetura e garante integração direta entre Meta e Solcon.

2.1. Configuração do portfólio de negócios Meta

1. Acesse o gerenciador de negócios da Meta.

2. Crie um novo portfólio de negócios.

3. Preencha todas as informações obrigatórias da empresa.

Esse portfólio será utilizado para vincular o aplicativo e o número do WhatsApp Business.

2.2. Criação do aplicativo Meta

1. Acesse o portal de desenvolvedores da Meta.

2. Crie um novo aplicativo.

3. Selecione a opção Outros como caso de uso.

4. Defina o tipo do aplicativo como Negócios.

5. Informe o e-mail de contato e associe o portfólio de negócios criado anteriormente.

2.3. Adicionar o produto WhatsApp ao aplicativo

1. No painel do aplicativo, acesse a seção de produtos.

2. Adicione o produto WhatsApp.

3. Inicie a configuração do WhatsApp no aplicativo.

Observação: a verificação do negócio pela Meta é obrigatória para acesso completo à API.

2.4. Geração de token permanente

Para garantir comunicação contínua entre Solcon e Meta, é necessário criar um token permanente.

1. Acesse as configurações comerciais do aplicativo.

2. Crie um Usuário do sistema com função de administrador.

3. Atribua ao usuário controle total sobre o aplicativo.

4. Gere um token de acesso permanente.

Permissões obrigatórias do token:

• whatsapp_business_manage_events

• whatsapp_business_management

• whatsapp_business_messaging

Armazene o token de forma segura.

2.5. Configuração da conta WhatsApp Cloud

1. Crie ou selecione uma conta comercial no Meta.

2. Informe o token permanente gerado.

3. Adicione um número de telefone válido para produção.

4. Realize a verificação do número via OTP.

2.6. Criação do canal WhatsApp no Solcon

1. Acesse o painel da Solcon.

2. Vá até Configurações → Canais → Adicionar canal.

3. Selecione WhatsApp.

4. Informe:

   • Número de telefone

   • ID do número do WhatsApp

   • ID da conta comercial Meta

5. Defina os membros da equipe que terão acesso ao canal.

2.7. Configuração do Webhook

O webhook permite que o Solcon receba mensagens enviadas ao número do WhatsApp.

1. Copie do Solcon:

   • URL do webhook

   • Token de verificação

2. No painel de desenvolvedor da Meta, acesse WhatsApp → Configuração.

3. Informe a URL do webhook e o token.

4. Confirme a verificação.

5. Ative a assinatura de eventos de mensagens.

2.8. Conclusão

Após a conclusão dessas etapas, o canal do WhatsApp via API Cloud estará ativo na Solcon. O time poderá enviar, receber e gerenciar mensagens diretamente pelo painel, utilizando todos os recursos de automação, atribuição e relatórios disponíveis.

3. Conexão WhatsApp via WAHA (WhatsApp HTTP API)

O WAHA é o método simplificado para integração self-hosted, onde a conexão é feita via QR Code.

1. Criação do Canal: Acesse Configurações → Canais → Adicionar canal e selecione o provedor WAHA.

2. Dados Necessários:

   • Nome do Canal de Atendimento: Digite um nome para identificar o canal.

   • Número de Telefone: Insira o número obrigatoriamente no formato: +55(DDD)9(Seu número).

3. Ativação: Clique em "Criar Sessão" ou "Criar canal do WhatsApp". O sistema gerará um QR Code na tela.

4. Finalização: Abra o WhatsApp no seu aparelho celular, vá em "Aparelhos Conectados" e escaneie o código exibido no painel da Solcon. O canal estará ativo e pronto para uso imediatamente após a leitura.

Adicionar agentes ao canal

Após criar a caixa de entrada, clique em Adicionar agentes para definir quem poderá atender conversas.

Configurações adicionais

O canal recém-criada estará disponível em:

Configurações → Canais → ícone de engrenagem

Os ajustes disponíveis são equivalentes aos oferecidos para os cansis, incluindo horários, assinatura, automações e roteamento.

Tipos de mídia suportados

A caixa de entrada WhatsApp do Solcon aceita os seguintes formatos:

Áudio

• aac

• mp4

• mpeg

• amr

• ogg

Compatível: usuário final e agente.

Documento

• text/plain

• application/pdf

• application/msword

• application/vnd.ms-excel

• application/vnd.ms-powerpoint

• formatos Office OpenXML (docx, xlsx, pptx)

Compatível: usuário final e agente.

Imagem

• jpeg

• png

Compatível: usuário final e agente.

Vídeo

• mp4 (usuário final e agente)

• 3gp (apenas usuário final)

Adesivos

• webp (somente usuário final)

IMPORTANTE: O Facebook permite apenas um único Webhook por aplicativo.
Se você tiver vários números, crie uma caixa de entrada Solcon para cada número, mas use o mesmo Webhook configurado no aplicativo.
Todas as caixas de entrada funcionarão normalmente.