Tema

Canais ​

Por onde os clientes falam com você: chat do site e WhatsApp (Evolution ou API oficial da Meta).

Menu Canais. É uma área para admins: só eles criam e editam canais. Cada canal aparece num cartão com o nome, o status (Conectado, Desconectado ou Sem verificação), o setor padrão e o fluxo.

Qual canal escolher?

Comece pelo chat do site: é grátis e sem risco. No WhatsApp, prefira a API oficial para volume alto ou para o número principal da empresa. A Evolution é prática para testes e números secundários, mas pode ser bloqueada pelo WhatsApp.

Configurações comuns a todo canal ​

Ao criar ou editar um canal, a seção Geral tem:

CampoPara que serve
Nome do canalSó para você identificar (por exemplo, Site principal).
Quando o cliente chamaVeja abaixo.
Fluxo de atendimentoQual fluxo recebe o cliente. Em Último fluxo publicado, o canal usa sempre o fluxo publicado mais recente.
Setor padrãoPara onde a conversa vai quando o fluxo não escolhe um setor (ou quando o canal começa direto com atendente).
Canal ativoDesligue para pausar sem apagar.

Quando o cliente chama ​

Vale também para quem volta depois de a conversa ser encerrada:

  • Começa pelo fluxo: boas-vindas e menu do robô; depois o cliente vai para o setor escolhido.
  • Direto com um atendente: pula o robô e entra na fila do setor padrão.

Veja como os fluxos se comportam em Fluxos.

Chat do site ​

  1. Clique em Criar canal e escolha Chat do site.
  2. Dê um nome, escolha o setor padrão e o fluxo.
  3. Em Domínios permitidos, adicione o endereço do seu site (sem https://).
  4. Salve. O canal fica pronto para instalar.

A aparência, o formulário e o código para colar no site ficam em Configurações > Chat do site. Tudo isso está explicado em Chat do site.

WhatsApp via Evolution ​

Não oficial

A Evolution usa o WhatsApp Web. A Meta pode bloquear o número. Para volume alto ou número principal, prefira a API oficial.

Conectar ​

  1. Criar canal > WhatsApp via Evolution.
  2. Informe a URL da Evolution, o nome da instância e a API key. Esses dados vêm da pessoa que administra a sua Evolution.
  3. Salve o canal.
  4. Na seção Conexão do WhatsApp, clique em Conectar a este painel. O WayChat configura sozinho o recebimento de mensagens (webhook) na instância.
  5. Se o celular estiver desconectado, aparece um QR code. No celular: WhatsApp > Aparelhos conectados > Conectar aparelho e leia o código.
  6. Quando aparecer Recebendo mensagens neste painel, mande uma mensagem de teste para o número.

O botão de atualizar (setas circulares) refaz a checagem de status. Se as mensagens estiverem indo para outro endereço, o painel mostra qual e o botão passa a ser Reaplicar configuração.

Configurar o webhook manualmente ​

Se preferir (ou se o passo automático não funcionar), a tela mostra a URL do webhook com um código secreto (?t=). Não compartilhe essa URL.

  1. No Evolution Manager, abra a instância e vá em Webhook.
  2. Ative o webhook e cole a URL.
  3. Marque os eventos MESSAGES_UPSERT e MESSAGES_UPDATE.
  4. Ligue Webhook Base64. Sem isso, áudios e imagens não chegam.
  5. Salve e envie uma mensagem de teste.

Na Evolution, menus viram texto numerado (o cliente responde com o número).

WhatsApp API oficial (Meta) ​

É a integração oficial: estável e sem risco de bloqueio por uso do WhatsApp Web. Exige uma conta na Meta (WhatsApp Business Platform).

Conectar ​

  1. Criar canal > WhatsApp API oficial (Meta).
  2. Preencha:
    • Phone number ID: o identificador do número no painel da Meta.
    • Versão da API: já vem preenchida; só mude se precisar.
    • Token de acesso e App secret: os segredos do seu aplicativo na Meta.
  3. Salve. O WayChat gera a URL do webhook e um verify token.
  4. No painel da Meta, abra WhatsApp > Configuração > Webhook.
  5. Cole a URL em URL de callback e o verify token em Verificar token.
  6. Assine o campo messages.

Menus com até 3 opções viram botões; com mais opções viram uma lista (até 10).

Segurança do webhook ​

Toda mensagem que chega da Meta traz uma assinatura (X-Hub-Signature-256). O WayChat confere essa assinatura com o App secret e descarta qualquer chamada que não bata. O verify token só serve para a Meta confirmar o endereço na primeira vez.

Segredos

Tokens, API keys e App secrets ficam guardados cifrados no servidor. Depois de salvos, a tela só mostra que existe um valor; para trocar, cole um novo ou use a opção de apagar.

Excluir ou pausar um canal ​

  • Canal ativo desligado: pausa sem perder nada.
  • Excluir canal: o balão some do site (no chat) ou as mensagens novas daquele número deixam de chegar ao painel. Pense bem antes de excluir.

Quando algo não chega ​

  • Confira o status do canal em Canais (Desconectado é a causa mais comum).
  • No chat do site, veja se o domínio está na lista de Domínios permitidos.
  • Na Evolution, repita o passo Conectar a este painel e confirme que o Webhook Base64 está ligado.
  • Na API oficial, confira se a URL, o verify token e o campo messages estão corretos na Meta.

Próximo passo: Fluxos.