Bots e IA
Quem usa: Administrador (habilitação e configuração das chaves). Atendentes e Supervisores usam os recursos de IA resultantes diretamente na tela de atendimento. O que é: o painel Bots e IA centraliza e gerencia todas as ferramentas de automação e modelos de linguagem (LLMs) que vão operar no sistema. A plataforma tem integração nativa com:- Construtores de Fluxo e Automação: Typebot, N8N, Dify e DialogFlow.
- Modelos de Inteligência Artificial (LLMs): ChatGPT, Grok, Gemini, Qwen, Claude, Deepseek, Ollama e LM Studio.
Abra a aba Bots IA
Defina o idioma padrão da IA
Escolha o provedor
Habilite o provedor
Automação total (opcional)
Passo final obrigatório: vincule ao canal
- A ativação dos provedores de IA é por conta do assinante. É preciso criar uma conta e configurar o provedor por fora (no site da OpenAI, Google, Anthropic, Groq etc.) e só depois habilitar dentro do PanÐá Zap.
- O Idioma das respostas de IA (página Bots e IA) é salvo automaticamente. Já nas páginas de cada provedor (ChatGPT, Gemini, Typebot etc.), as mudanças só valem depois de clicar em Salvar, no topo da página.
Integrações
Quem usa: Administrador. O que é: o hub de Integrações Externas do PanÐá Zap: uma segunda aba de Configurações, separada da “Integrações Meta”, que reúne conectores com provedores de WhatsApp não oficiais, canais de BSP, ferramentas de voz/SMS/IA e utilitários como Webhooks, Webchat e Google Calendar. Cada um dos itens abaixo corresponde a uma página do menu lateral desta aba. Como acessar: menu Configurações → Integrações.BSP: Dialog360 e Gupshup
BSP: Dialog360 e Gupshup
- Acesse Configurações → Integrações → BSP e selecione a aba Dialog360.
- Em Canais, veja a lista de canais WhatsApp Business já conectados via 360dialog (colunas: Nome, Channel ID, Telefone, Status, Qualidade, Ações).
- Clique em + Novo Canal e escolha um dos dois modos:
- Manual: para contas 360dialog comuns (Customer Account). Cole a D360-API-KEY emitida no WABA Manager: ao clicar para abrir, os campos (D360-API-KEY, Phone Number ID, WABA ID) são preenchidos em uma janela segura (popup).
- Onboarding: exclusivo para Tech Providers/Partners com credenciais oficiais 360dialog: abre o fluxo oficial 360dialog para autorizar a conexão e receber as credenciais automaticamente (clique em Conectar via Dialog360). Se você não tem relação Partner ativa com o 360dialog, use o modo Manual.
- Em Templates, clique em + Novo Template e preencha:
- Em Credenciais, configure os dados de Partner apenas se sua empresa atuar como BSP em nome de outras empresas: Partner ID (identificador alfanumérico do painel 360dialog, não é o e-mail), Partner API Key e Platform Secret (segredo HMAC do webhook). Deixe em branco se for usar o fluxo Manual com Customer Account. O salvamento é automático ao digitar.
- Selecione a aba Gupshup.
- Em Canais, clique em + Novo Canal e escolha:
- Manual: para contas Gupshup comuns, cole App ID e App Token do painel Gupshup; os demais campos (API Key, Phone Number ID, WABA ID) são preenchidos em popup seguro.
- Cadastro incorporado: exclusivo para Tech Providers/Partners com Solution ID aprovado: informe o Nome do canal (opcional) e o App ID criado em
partner.gupshup.io, depois clique em Iniciar Cadastro incorporado.
- Em Templates, use o seletor de canal no topo e clique em + Criar Template, preenchendo os mesmos campos do Dialog360 (Nome, Idioma, Categoria, Header, Corpo, Footer, Botões). O formulário Gupshup conta com o botão ✨ Gerar com IA para criar o corpo do template a partir de um prompt.
- Em Credenciais, configure os dados de Partner (Partner Email, Partner Password, Solution ID, App ID opcional) apenas se for atuar como BSP para outras empresas; para uma conta Customer comum, deixe em branco e use o fluxo Manual (nesse caso, o webhook precisa ser configurado manualmente no painel do app Gupshup).
- Partner Account x Customer Account: uma Partner Account (criada em
hub.360dialog.comoupartner.gupshup.io) permite criar canais e emitir credenciais em nome de vários clientes, e exige cadastro e aprovação separados junto ao BSP. Uma Customer Account comum só gerencia os canais criados no próprio painel do BSP. Para conectá-la ao PanÐá Zap, use sempre o fluxo Manual, sem preencher os campos de Partner.
Rastreamento de Conversão Meta Ads
Rastreamento de Conversão Meta Ads
CTWA Click ID, permitindo saber exatamente qual anúncio gerou cada atendimento: informação que também é devolvida à Meta para otimizar o algoritmo de entrega de anúncios e encontrar leads mais qualificados.- No menu principal, clique em Configurações → Integrações e, no submenu lateral esquerdo, clique em Conversões Ads.
- Na aba Configurações, clique em + Nova credencial para cadastrar as chaves de acesso:
-
Clique em + Nova regra para definir o que dispara uma conversão. Cada regra liga uma credencial a um evento, então crie uma regra para a credencial da Meta e outra para a do GA4:
- Em Credencial, escolha a credencial cadastrada (Meta / Facebook ou Google GA4).
- Em Gatilho, selecione Conversa Iniciada via Anúncio (WABA/Instagram/Messenger) (na lista de regras, ela aparece com Atribuição de anúncio real). Os gatilhos Campanha Enviada, Comunicado (API Não Oficial) e Comunicado (API Oficial) aparecem marcados como Sem atribuição de anúncio. O gatilho Oportunidade ganha no funil, que manda à Meta as vendas fechadas no Funil de Vendas, tem regras próprias: veja o passo 7.
- Em Nome do evento, use preferencialmente
LeadSubmitted(ouLead) na regra da Meta: é esse nome que aparece no Gerenciador de Anúncios para otimização de campanha. Na regra do GA4, defina um nome comoqualify_leadougenerate_leadpara fins de relatório no Analytics. - Opcionalmente, informe Valor (opcional) e Moeda, e mantenha Ativo ligado.
-
Configure a campanha na Meta como do tipo “Cliques para o WhatsApp” (destino direto no WhatsApp): é esse formato que faz a Meta anexar o
CTWA Click IDquando o cliente clica no anúncio e envia mensagem. O PanÐá Zap identifica esse parâmetro automaticamente e devolve a confirmação de conversão para Meta e Google. - Na aba Relatórios de Anúncios, filtre por período, canal ou ID do anúncio para auditar os resultados: a tabela mostra Título do Anúncio, Contato, número do Ticket e o código CTWA Click ID; o Status do Evento mostra Enviado quando a conversão foi enviada com sucesso; use “Ver anúncio” para visualizar a peça criativa. Contatos que chegam por anúncio numa conexão por QR Code também entram no relatório, com o canal WhatsApp (QR Code) (opção também do filtro Canal) e o status Sem envio à Meta: essas conexões não enviam o evento de conversão à Meta, então não há reenvio, e o lead aparece no relatório, no selo do atendimento e na etiqueta automática.
- Para dar uma etiqueta automática a quem chega por anúncio, volte à aba Configurações: no fim dela, o quadro Contatos vindos de anúncio tem o campo Etiqueta automática. Escolha a etiqueta (o padrão é Nenhuma (desligado)) e clique em Salvar (aviso Etiqueta automática salva). Quando um contato chega por anúncio do Instagram, do Messenger ou do WhatsApp (oficial ou por QR Code), ele ganha essa etiqueta. Vale para os contatos que chegarem depois de salvar; a etiqueta vai para o contato e aparece nas listas e nos filtros; o mesmo contato pelo mesmo anúncio conta uma vez a cada 24 horas; e, se a etiqueta for excluída, a etiqueta automática se desliga. No atendimento, esses contatos aparecem com o selo Anúncio (veja Atendimento).
-
Vendas fechadas no Funil de Vendas: para mandar à Meta a venda de cada oportunidade marcada como Ganho, clique em + Nova regra e escolha o gatilho Oportunidade ganha no funil. Ele só funciona com credencial da Meta: em Credencial aparecem só as da Meta e, sem nenhuma cadastrada, o gatilho fica bloqueado com o aviso Cadastre uma credencial da Meta para usar este gatilho. Se o Nome do evento estiver vazio, ao escolher o gatilho ele é preenchido com
Purchase(dá para trocar). Os campos Valor (opcional) e Moeda somem: a venda vai com o valor da oportunidade e a moeda da região da empresa (campo Moeda do card Região e idioma, em Configurações), e a coluna Valor da lista de regras mostra Valor da oportunidade. Só pode haver uma regra ativa deste gatilho: com outra já ativa, a tela avisa Já existe uma regra ativa de oportunidade ganha. Desative a outra antes de ativar esta. No formulário, o quadro Como a venda é enviada resume as regras, e o ícone de informação ao lado do título traz os detalhes:- Só sai venda de contato que veio de anúncio no WhatsApp oficial, no Messenger ou no Instagram. Conexões da Dialog360, da Gupshup e por QR Code não registram o clique no anúncio, então não geram venda.
- A oportunidade precisa estar com o valor preenchido. Cada oportunidade manda no máximo uma venda, mesmo se for reaberta e ganha de novo.
- Não são enviadas as oportunidades ganhas antes de criar a regra nem as que o fluxo já cria ganhas.
- No Instagram a Meta mede a venda, mas não otimiza a campanha por compra.
- Google Ads é diferente da Meta: o Google Ads não envia o ID de clique nativamente dentro da mensagem do WhatsApp. A integração com Google aqui serve para alimentar o GA4 com relatórios de volume, mas não otimiza lances de campanhas de pesquisa diretamente como ocorre com Facebook/Instagram.
- Em alguns casos a Meta cria um conjunto de dados automático para mensagens (por exemplo, “PanÐá Zap Event Data”). Verifique no Gerenciador de Eventos se o Pixel ID que você está usando é o mesmo que está recebendo os eventos de mensagem.
Habilitar Webhooks
Habilitar Webhooks
- Acesse Configurações → Integrações → Webhooks.
- Ative o toggle Ativar webhook.
- Informe a URL do Webhook: o endereço público, em HTTPS, que receberá as requisições POST com os dados dos eventos.
- Se quiser receber eventos de novas mensagens e atendimentos, ative também Webhook mensagens. Para receber o status das mensagens enviadas, ative Webhook status de envio (desligado por padrão): ele avisa a sua URL quando cada mensagem enviada é aceita, entregue, lida ou falha, com o motivo do erro. Por enquanto vale só para o WhatsApp oficial direto, inclusive para as mensagens de campanha, e cada mensagem enviada gera até 3 avisos. Os avisos podem chegar fora de ordem: use o horário de cada um para ordenar. Se a sua URL não responder em 10 segundos, o aviso não é reenviado; se ela demorar a responder e os avisos acumularem, os excedentes são descartados. A explicação fica no ícone de interrogação ao lado do nome da opção.
- Clique em Salvar.
- Role até Eventos de canal e usuário e ative, individualmente, os eventos que deseja monitorar: Webhook criar canal, Webhook atualizar canal, Webhook criar usuário, Webhook atualizar usuário, Webhook criar API, Webhook atualizar API e Webhook renovar API. Cada toggle é independente.
- Clique em Salvar novamente.
- A URL precisa ser pública, acessível externamente, aceitar requisições POST e usar HTTPS. URLs locais (
localhost) não funcionam. - Eventos não chegam na sua URL? A causa mais comum é a URL estar inacessível externamente, sem HTTPS, ou com firewall bloqueando entradas. Use um serviço como o RequestBin para gerar uma URL temporária de teste e confirmar que os eventos estão sendo disparados pelo PanÐá Zap antes de apontar para a URL definitiva.
- Se um evento não chegar, confira se o webhook e o tipo de evento estão ativados e se a URL está acessível pela internet e responde rápido. O Log de Auditoria registra as ações feitas no sistema, não os avisos enviados para a sua URL: para ver o que está chegando, use a URL de teste (como a do RequestBin) da dica acima.
- Eventos do Funil e do Kanban: Webhook criar usuário e Webhook atualizar usuário também enviam os eventos das oportunidades do Funil de Vendas, identificados no campo
method:create-opportunity(com Webhook criar usuário ligado),update-opportunityedelete-opportunity(com Webhook atualizar usuário ligado; a exclusão manda só o número da oportunidade). Com Webhook atualizar usuário ligado sai tambémcontact-update-kanban, quando a coluna do Kanban de atendimento de um contato é trocada. Esses eventos saem só quando a mudança é feita pelo painel: mudanças pela API, por ações automáticas, fluxos, formulários ou Agentes de IA não geram evento.
Habilitar Webchat
Habilitar Webchat
- Certifique-se de que já existe um canal do tipo Webchat instalado e conectado (pré-requisito).
- Acesse Configurações → Integrações → Webchat e confira o quadro de status, no topo. O teste confere a conexão em tempo real do chat (
/wss), por onde o visitante recebe as respostas na hora:- Webchat configurado e funcionando corretamente. (verde): a linha WebSocket (porta principal) mostra Ativo, ou Ativo (conferido pelo navegador) quando o teste feito pelo servidor falhou, mas o seu navegador abriu a conexão pelo mesmo caminho do visitante. Nesse caso, a nota logo abaixo mostra o motivo do teste do servidor e lembra que isso não afeta o Webchat.
- conferindo pelo navegador… (amarelo): o servidor não conseguiu testar a conexão e a tela está conferindo pelo seu navegador. Aguarde alguns segundos.
- A URL WSS não está respondendo. (vermelho): nem o servidor nem o navegador conseguiram abrir a conexão. A tela mostra o motivo do teste do servidor (por exemplo, sem resposta em 5 segundos ou conexão recusada) e dicas para quem cuida do servidor. Gerar Widget e o link direto continuam liberados, com o aviso O WebSocket não respondeu nos testes. Você pode gerar o widget e configurar o link direto, mas o visitante só recebe as respostas na hora depois que o /wss responder. Se o aviso continuar, fale com o suporte do PanÐá Zap.
- Webchat não configurado. (amarelo): fale com o suporte do PanÐá Zap.
- Em Canal Webchat, selecione a sessão Webchat que receberá os atendimentos vindos do site.
- Se desejar, marque Habilitar botões de menu (#MENU): quando ativo, mensagens no formato
#MENUsão renderizadas como botões clicáveis no widget. - Clique em Gerar Widget.
- Copie o código JavaScript gerado e cole no HTML do site, antes do fechamento da tag
</body>, dentro de<script>...</script>(o código vem sem essas tags). - Teste enviando uma mensagem pelo widget: ela deve chegar na plataforma como um novo atendimento. Na janela Código do Widget também há o botão Testar Widget, que abre um ambiente de teste sem mexer no seu site.
- Incorporar no site (código): o código gerado acima, ideal para sites próprios: o balão de chat aparece no canto da página.
- Link direto (URL pública): ative Ativar link direto para gerar uma página pública de conversa do canal, com URL pública (botão Copiar link) e QR Code. É ideal para aplicativos, QR Codes impressos, pop-ups e portais onde não dá para colar código. Desligado, o link não funciona. Parâmetros opcionais na URL (
?nome=&telefone=&email=&origem=) preenchem os dados do contato automaticamente na primeira mensagem. Com o link direto ligado, o quadro mostra também, logo abaixo do QR Code, Receber pelo link de convite: com ele, o cliente que conversa com a empresa pelo WhatsApp recebe um link pessoal (variável{{linkWebchat}}) e continua a conversa no WebChat como o mesmo contato. Ligado, ele mostra também o campo Texto do convite (botão Salvar texto): a mensagem que o atendente envia pelo botão Enviar convite do WebChat do atendimento. Veja como ligar e os cuidados em Link de convite do WebChat.
- Aparência: Título, Cor principal, URL do logotipo, Mensagem de boas-vindas e Texto do campo de digitação.
- Formulário inicial: ative Solicitar dados antes de iniciar, escolha os Campos exibidos (Nome, E-mail, Telefone, CPF) e os Campos obrigatórios, e, se quiser, preencha Texto de consentimento (privacidade) e URL da política de privacidade. O formulário aparece só para quem abre a conversa pelo link direto.
- Textos da página: substitui os textos padrão da página pública (útil para atender em outro idioma).
- O Token de Autenticação vai dentro do código do widget, por isso fica visível para quem abrir o código do site. Ele liga o widget ao canal; não é a senha do painel nem o token da API, e não limita em qual site o widget pode ser instalado. Se mensagens estranhas começarem a chegar pelo widget, ou se um site deixar de usar o widget, use o ícone de renovar (↺) para gerar um novo e reinstale o código nos sites que continuam.
- Para um widget com o visual do seu site, veja Widget personalizado.
Habilitar Google Calendar
Habilitar Google Calendar
- Pré-requisito: crie as credenciais OAuth (Client ID e Client Secret) no Google Cloud, conforme o passo a passo Como criar as credenciais no Google Cloud, logo abaixo.
- Acesse Configurações → Integrações → Google Calendar e clique em + Nova configuração.
- Dê um Nome para identificar a integração (ex.: “Meu Calendário”).
- Informe o Client ID e o Client Secret obtidos no Google Cloud Console. Depois de salvo, o Client Secret pode aparecer oculto, com o aviso Valor salvo e oculto por segurança. Para trocar, digite um novo. Nesse caso, se trocar o Client ID, digite o Client Secret de novo: a tela avisa Ao trocar o Client ID, digite o Client Secret de novo. O secret salvo só vale para o Client ID anterior. e não salva nem abre o Google sem ele. O Duplicar configuração também não copia o Client Secret oculto: digite-o na configuração nova.
- Copie a URI de Redirecionamento exibida pelo sistema e cadastre-a como URI autorizada no seu projeto do Google Cloud Console. Cadastre também
https://oauth.pandazap.com/callback.html(completo, terminando em/callback.html). - Clique em Obter tokens via Google (OAuth) e autorize o acesso à conta Google desejada: os campos Access Token e Refresh Token são preenchidos automaticamente. Ao terminar, a janela de autorização se fecha sozinha. Se ela continuar aberta, mostra Pode fechar esta janela e voltar à tela anterior: ela se atualiza sozinha. e o botão Abrir as configurações da agenda: feche a janela e volte à tela de configuração, que confere a conexão sozinha a cada poucos segundos (e quando você volta para ela), sem precisar recarregar. Vale também ao reconectar pelo ícone de link azul da lista. Essa conferência automática dura até 10 minutos: se a autorização demorar mais, recarregue a página (F5) para ver a situação. Se você mudou o nome ou as credenciais de uma configuração já salva, eles são gravados antes de abrir o Google. Se o retorno do Google abrir fora da janela do painel (por exemplo, no navegador do celular, quando a conexão é feita pelo aplicativo Android), a página pergunta se deve conectar a conta Google (com os nomes da agenda e da empresa, quando consegue mostrá-los) e só conecta depois do botão Conectar (Cancelar não grava nada). Confirme só se foi você quem pediu a conexão no painel: quem tem acesso à agenda nesse painel vai poder ver, criar e alterar os eventos da conta Google. Se o servidor demorar a responder, a página avisa O servidor demorou a responder. A tela de configurações da agenda confere sozinha se a conexão foi concluída.
- Clique em Salvar.
- Para consultar ou criar eventos sem sair da tela de configurações, use a seção Eventos do Google Calendar: selecione o Calendário, defina Data início/fim e Máx. resultados, e clique em Buscar, ou clique em + Novo evento e preencha Título, Data/hora início e fim (obrigatórios), Descrição, Local e Participantes (opcionais).
- Defina a agenda padrão: clique na estrela da configuração (Definir como agenda padrão). Ela é usada pelo link de reunião do atendimento e pelas páginas de agendamento que não têm agenda própria.
- Teste a conexão: veja a última dica desta seção (Buscar e evento de teste).
- (Opcional) Link de reunião com Google Meet: em Configurações → Gerais, escolha Google Meet em Provedor de Videochamada e recarregue (F5) as telas de atendimento abertas. Em conta Google Workspace, deixe o Tipo de acesso das reuniões em Abrir para que clientes de fora da empresa entrem sem pedir para participar.
- (Opcional) Agendamento Público: em cada página, escolha a agenda em Agenda do Google desta página (ou Usar a agenda padrão).
- Entre em console.cloud.google.com com a conta Google da agenda que será conectada. Em conta Google Workspace, a agenda precisa ser de um usuário com licença: endereço de grupo ou alias não tem agenda própria.
- Clique em Selecione um projeto → Novo projeto, dê um nome e, em conta Google Workspace, escolha a organização da empresa em Recurso pai. No primeiro acesso de uma conta Workspace, o Google cria a organização na hora e ela pode levar alguns minutos para aparecer: se surgir erro de permissão ao criar o projeto, recarregue a página (F5) e tente de novo.
- Ative a Google Calendar API (APIs e serviços → Biblioteca).
- Em Google Auth Platform, clique em Começar e preencha o nome do app, o e-mail de suporte, o e-mail de contato e o Público:
- Interno: só contas do mesmo Google Workspace da empresa podem conectar, sem verificação do Google. Indicado quando a agenda é de um usuário do próprio domínio.
- Externo: qualquer conta Google pode conectar. Publique o app (status Em produção) em Público-alvo: em modo de teste, a conexão expira em 7 dias. Sem a verificação do Google, a tela de autorização mostra o aviso de app não verificado.
- Em Acesso a dados, clique em Adicionar ou remover escopos, marque
.../auth/calendare.../auth/calendar.eventse salve. - Em Clientes → Criar cliente, escolha Aplicativo da Web e, em URIs de redirecionamento autorizados, cadastre a URI exibida no campo URI de Redirecionamento da tela do PanÐá Zap e também
https://oauth.pandazap.com/callback.html, as duas completas. - Ao criar, copie o Client ID e o Client Secret (ou baixe o JSON): o Google mostra o Secret completo uma única vez. Se perder, adicione um novo Secret no mesmo cliente.
- Em conta Google Workspace, se a autorização for bloqueada por política da empresa, o administrador libera o app em admin.google.com → Segurança → Acesso e controle de dados → Controles de API, marcando o Client ID como confiável.
- Para reconectar uma configuração com Tokens: Pendente, clique no ícone de link azul na linha dela (Obter tokens via Google (OAuth)) e autorize de novo.
- Use o ícone de estrela para Definir como agenda padrão: a agenda padrão é a usada quando ninguém escolhe uma, como no link de reunião criado no atendimento e nas páginas de agendamento sem agenda própria. Só uma agenda já conectada ao Google pode ser a padrão.
- É possível cadastrar múltiplas contas/configurações (há também o ícone Duplicar configuração), útil, por exemplo, para ter uma agenda por vendedor ou por unidade.
- Dê à configuração um Nome sem acentos (ex.: “Agenda Comercial”): nome com acento pode impedir que a autorização do Google volte para a configuração certa.
- No modal, o aviso ⚠ Preencha todos os campos obrigatórios só vira ✓ Configuração completa quando os tokens chegam. Clique em Obter tokens via Google (OAuth), autorize com a conta desejada e aguarde: a configuração é salva sozinha e aparece com Status Ativo e Tokens Completo.
- Mudanças feitas no Google Cloud, como as URIs de redirecionamento, podem levar de alguns minutos a algumas horas para valer. Se o Google mostrar
redirect_uri_mismatchlogo depois do cadastro, confira as duas URIs e tente de novo mais tarde. - Os eventos criados pelo sistema ficam só na agenda conectada: quem estiver em Participantes não recebe convite por e-mail.
- Para conferir a conexão, use a seção Eventos do Google Calendar desta tela: escolha a agenda em Calendário, clique em Buscar (sem erro, mesmo que a lista venha vazia) e, se quiser, crie um evento de teste em + Novo evento e confira se ele aparece no Google Agenda da conta conectada.
Habilitar Z-API
Habilitar Z-API
- Contrate um plano diretamente em
z-api.ioe obtenha sua Global Key. O Z-API é pago e independente do PanÐá Zap. - Acesse Configurações → Integrações → Z-API.
- Preencha a URL da API (o campo sugere
https://api.z-api.io; use outro endereço somente se você usa uma instância self-hosted do Z-API) e a Global Key. - As alterações são salvas automaticamente ao sair do campo.
- Com as credenciais salvas, crie o canal: acesse Canais → Adicionar Canal, selecione o tipo Z-API, escolha a sessão Z-API correspondente ao número desejado, preencha o nome do canal e as configurações de atribuição (fila ou usuário) e salve.
Habilitar UazAPI
Habilitar UazAPI
- Tenha uma instância UazAPI já instalada e rodando em um servidor (saiba mais em
uazapi.dev): a instalação em si é um processo separado, de infraestrutura, e não é feita nesta tela. - Acesse Configurações → Integrações → UazAPI.
- Preencha a URL da API (URL base da sua instalação, ex.:
https://uazapi.suaempresa.com) e a Global Key (chave gerada no painel da sua instalação). - As alterações são salvas automaticamente ao sair do campo.
- Crie o canal em Canais → Adicionar Canal, tipo Uazapi, selecionando a sessão correspondente, nome do canal e configurações de atribuição, e salve.
Habilitar Evolution
Habilitar Evolution
- Tenha uma instalação da Evolution API já rodando no seu servidor (há um tutorial de instalação dedicado na documentação oficial, caso ainda não tenha feito esse processo de infraestrutura).
- Acesse Configurações → Integrações → Evolution API.
- Preencha a URL da API (URL base da instalação no seu servidor, ex.:
http://SEU_IP:5555) e a Global Key (chave global definida no arquivo.envda Evolution, variávelAPP_ADMIN_TOKEN). - Use o botão Verificar Status da API (canto superior direito) para confirmar que a URL e a chave estão corretas e a API está acessível.
- Vá em Canais para adicionar uma nova instância e conectar um número de WhatsApp via QR Code.
Habilitar Evolution Go
Habilitar Evolution Go
- Tenha uma instalação da Evolution Go API já rodando no seu servidor.
- Acesse Configurações → Integrações → Evolution Go.
- Preencha a URL da API (URL base da instalação) e a Global Key. As alterações são salvas automaticamente.
- Use o botão Verificar Status da API (canto superior direito), que abre o painel da sua API em uma nova aba, para confirmar que ela está acessível.
- Crie o canal do tipo Evolution Go em Administração → Canais e leia o QR Code.
Habilitar Wuzapi
Habilitar Wuzapi
- Tenha uma instalação WuzAPI já rodando no seu servidor.
- Acesse Configurações → Integrações → WuzAPI.
- Preencha a URL da API (URL base da sua instalação) e a Global Key (chave global gerada na sua instância WuzAPI). As alterações são salvas automaticamente.
- Use o botão Verificar Status da API (canto superior direito): ele abre a página da sua API em uma nova aba, para você confirmar que ela está respondendo.
- Crie o canal do tipo Wuzapi em Administração → Canais e leia o QR Code.
Habilitar Hub NotificaMe
Habilitar Hub NotificaMe
- Obtenha o token de autenticação no painel do Hub Notificame.
- Acesse Configurações → Integrações → Hub.
- Cole o token no campo Token Hub. As alterações são salvas automaticamente.
- Crie um canal do tipo Hub Notificame em Administração → Canais.
Habilitar Rocket.Chat
Habilitar Rocket.Chat
- Confirme o pré-requisito: é preciso haver um servidor Rocket.Chat configurado. Se nenhum estiver disponível, esta tela mostra um aviso e o toggle fica bloqueado: nesse caso, cadastre o servidor da sua empresa em Configurações → Apps → Rocket.Chat (ou solicite ao suporte do PanÐá Zap).
- Acesse Configurações → Integrações → Rocket.Chat.
- Ative o toggle Habilitar Rocket.Chat. A mudança é salva na hora, sem botão Salvar.
- A partir daí, os agentes acessam o chat interno em Comunicação e Marketing → Redes Sociais → Rocket.Chat, já logados na própria conta.
Habilitar SMS
Habilitar SMS
- Acesse Configurações → Integrações → SMS.
- Escolha um ou mais dos três provedores suportados e informe o respectivo token:
- Se a sua chave foi criada no painel novo da Comtele, aparece logo abaixo o campo Rota de envio (Comtele), porque esse painel exige uma rota em cada envio. Cada rota tem preço e prioridade de entrega próprios. Deixe em Automática - a mais barata (o sistema usa a rota mais barata da sua conta; a opção mostra o nome e o preço dela) ou escolha uma rota fixa da lista, que mostra o nome e o preço de cada uma. A troca é salva na hora. Se a rota escolhida deixar de existir na sua conta Comtele, ela aparece com o aviso (não existe mais na conta): escolha outra. Com chave do painel antigo, o campo não aparece.
- As alterações são salvas automaticamente. É possível configurar mais de um provedor e escolher qual usar no momento do envio.
- Mantenha os tokens atualizados conforme a renovação exigida em cada painel de provedor.
- Verifique o saldo disponível diretamente no site do provedor antes de programar envios em volume.
- Combinada à aba SMS dos Comunicados, esta integração permite campanhas de SMS além dos disparos individuais durante o atendimento.
Habilitar GroqCloud
Habilitar GroqCloud
- Crie uma conta em
console.groq.come gere uma API Key. O GroqCloud é um serviço de terceiros, pago e independente do PanÐá Zap. - Acesse Configurações → Integrações → GroqCloud.
- Ative Habilitar GroqCloud. Logo abaixo fica a opção Transcrever também os áudios enviados pelo atendente (desligada por padrão; ligar ou desligar grava na hora): com ela, as mensagens de voz gravadas no painel também ganham a transcrição logo abaixo, alguns segundos depois do envio. Vale só para a mensagem de voz que o atendente grava no painel (microfone ou resposta rápida de voz) e usa a mesma chave e o mesmo limite de uso do GroqCloud dos áudios recebidos. Arquivo de áudio anexado, áudios de fluxo, robô, agente de IA, campanha ou API e áudio que falhou no envio não são transcritos. Sem o GroqCloud ativo e com chave, a opção fica ligada mas não transcreve, e a tela avisa A opção só transcreve com o GroqCloud ativo e com chave (desta empresa ou do provedor global).
- Informe a API Key gerada.
- Selecione o Idioma predominante dos áudios recebidos (configure corretamente para melhorar a precisão da transcrição).
- Escolha o Modelo: Whisper Large v3 (mais preciso), Whisper Large v3 Turbo ou Distil Whisper Large v3 (EN only), este último só para áudios em inglês.
Habilitar VAPI
Habilitar VAPI
- Crie uma conta em
vapi.aie obtenha o token de API (há um botão Criar conta VAPI na própria tela, caso ainda não tenha uma conta). - Acesse Configurações → Integrações → VAPI.
- Informe o Token da API VAPI.
- Após salvar o token, a página carrega automaticamente os Assistentes (assistentes de voz configurados na sua conta) e os Números de Telefone (números de saída disponíveis para chamadas).
- Para testar, clique em Fazer Chamada de Teste: selecione o assistente, escolha o número de saída (o número VAPI que fará a ligação), informe o número do cliente que receberá a chamada e confirme: a chamada é iniciada imediatamente.
- Configure múltiplos assistentes para diferentes finalidades (triagem, cobrança, suporte).
- Sempre valide as respostas do assistente com uma chamada de teste antes de ativá-lo em produção.
- Verifique saldo e logs de chamadas diretamente no painel
vapi.ai.

