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
Preencha a API Key
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.
- As alterações desta página são salvas automaticamente assim que os campos são preenchidos ou os botões de seleção são alterados: não existe um botão “Salvar” separado.
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; os campos são preenchidos em um popup seguro com validação de licença.
- 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:
- 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.
- Embedded Signup: 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 Embedded Signup.
- 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 outros tenants; 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:
- Em Gatilho, selecione “Conversa Iniciada via Anúncio (WABA/Instagram/Messenger)”.
- Em Evento (Meta), use preferencialmente
LeadSubmitted(ouLead): é esse nome que aparece no Gerenciador de Anúncios para otimização de campanha. - Em Evento (G.A), defina um nome como
qualify_leadougenerate_leadpara fins de relatório no Analytics.
- 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 confirma se a conversão foi “Enviada” com sucesso; use “Ver anúncio” para visualizar a peça criativa.
- 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.
- Clique em Salvar.
- Role até Eventos de canal e usuário e ative, individualmente, os eventos que deseja monitorar: Webhook criar/atualizar canal, Webhook criar/atualizar usuário e Webhook criar/atualizar/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.
- Para verificar se o webhook está disparando corretamente, consulte o Log de Auditoria: ele guarda o histórico de eventos enviados e ajuda a identificar erros ou falhas no disparo.
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 se o painel de status exibe, em verde, a mensagem confirmando que o serviço está ativo.
- 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>. - Teste enviando uma mensagem pelo widget: ela deve chegar na plataforma como um novo atendimento.
- O Token de Autenticação garante que apenas o seu site possa enviar mensagens via widget. Não o compartilhe. Se ele for comprometido ou exposto, use o ícone de renovar (↺) para gerar um novo.
- O WebSocket do Webchat passou a funcionar na mesma porta do backend, eliminando a necessidade de configurações separadas de porta; widgets antigos e novos continuam funcionando simultaneamente durante a transição. Esse é um detalhe mais técnico de infraestrutura, normalmente tratado pela equipe responsável por manter a instalação. O Administrador do tenant não precisa agir sobre ele para o widget funcionar.
Habilitar Google Calendar
Habilitar Google Calendar
- Pré-requisito: crie um projeto no Google Cloud Console, ative a Google Calendar API e gere credenciais OAuth (Client ID e Client Secret) antes de configurar aqui.
- 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.
- Copie a URI de Redirecionamento exibida pelo sistema e cadastre-a como URI autorizada no seu projeto do Google Cloud Console.
- Clique em Obter tokens via Google e autorize o acesso à conta Google desejada: os campos Access Token e Refresh Token são preenchidos automaticamente.
- 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).
- Apenas configurações com Status: Ativo e Tokens: Completo aparecem no seletor de calendário nas demais telas do sistema.
- Use o botão Conectar Google Calendar no topo da tela para reconectar rapidamente uma conta cujos tokens expiraram (Status: Pendente), sem precisar abrir o modal completo novamente.
- É possível cadastrar múltiplas contas/configurações, útil, por exemplo, para ter uma agenda por vendedor ou por unidade.
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 (padrão
https://api.z-api.io; altere 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 WhatsApp 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 WhatsApp 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 Wuzapi
Habilitar Wuzapi
- Tenha uma instalação WuzAPI já rodando no seu servidor (há tutoriais dedicados de instalação e de conexão de canal na documentação oficial).
- 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).
- 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á respondendo.
Habilitar Hub NotificaMe
Habilitar Hub NotificaMe
- Contrate o serviço com o apoio da equipe do PanÐá Zap.
- Acesse Configurações → Integrações → Hub NotificaMe.
- Informe Seu token notificame no campo correspondente.
Habilitar Rocket.Chat
Habilitar Rocket.Chat
- Confirme o pré-requisito: o Super Administrador da plataforma precisa ter configurado um servidor Rocket.Chat antes de esta integração poder ser ativada (se nenhuma configuração estiver disponível, um aviso aparece nesta tela: nesse caso, solicite à equipe que administra a plataforma que configure o “App Rocket.Chat”).
- Acesse Configurações → Integrações → Rocket.Chat.
- Ative o toggle Habilitar Rocket.Chat.
- Salve.
- A partir daí, os agentes acessam o chat interno em Comunicação e Marketing → Redes Sociais → Rocket.Chat.
Habilitar SMS
Habilitar SMS
- Acesse Configurações → Integrações → SMS.
- Escolha um ou mais dos três provedores suportados e informe o respectivo token:
- 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 ao Envio em Massa, 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.
- 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) ou Distil Whisper (mais rápido).
- Se quiser transcrever em todos os canais ativos, ative a opção para todos os tickets.
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.

