Pular para o conteúdo principal
Esta página reúne as duas telas de Configurações onde o Administrador cadastra credenciais, URLs e chaves de serviços externos usados pela plataforma: a aba Bots IA (provedores de automação e de inteligência artificial) e a aba Integrações (BSPs, webhooks, webchat, Google Calendar, gateways não oficiais de WhatsApp, SMS, voz e outros conectores). Nenhuma dessas telas conecta um canal sozinha: elas apenas guardam as credenciais globais da conta. A criação efetiva do canal (número de WhatsApp, sessão, widget etc.) acontece depois, no menu Canais, documentado nas páginas específicas de cada tipo de canal. Pense nesta página como o “cofre de chaves” que os canais, o Chat Flow, os Agentes de IA e outros módulos vão buscar quando precisam falar com um serviço de fora do PanÐá Zap.
Esta página trata da aba Integrações, separada da aba Integrações Meta (conexão oficial com WhatsApp Business API, Instagram e Messenger direto pela Meta), que é documentada em outra página do Guia da Plataforma.

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.
1

Abra a aba Bots IA

Clique no menu Configurações e selecione a aba Bots IA.
2

Defina o idioma padrão da IA

Na primeira página da aba, Bots e IA, escolha no card Idioma padrão da IA o campo Idioma das respostas de IA, com o idioma principal do seu público (por exemplo, Português): é o idioma que a IA usa ao descrever imagens e mídias recebidas e ao sugerir ou reescrever mensagens para o cliente nos atendimentos. Por padrão, o campo fica em Seguir a Região, opção que acompanha o Idioma das mensagens ao cliente definido em Configurações → Gerais → Geral, no card Região e idioma: se esse idioma for trocado depois, a IA passa a usar o novo sem você voltar aqui. Sem idioma definido naquele card, a IA responde em Português. Para fixar a IA em um idioma próprio, escolha-o na lista. Essa escolha é salva automaticamente.
3

Escolha o provedor

No menu lateral de Bots IA, clique no provedor desejado (por exemplo, ChatGPT).
4

Habilite o provedor

Ative a chave Habilitar [Nome da IA]: sem isso, a IA não aparece como opção nos canais. A página do provedor não tem campo de API Key: a chave é informada depois, na configuração do canal (último passo). Depois de ajustar as chaves desta página (inclusive a do passo seguinte, se for usar), clique em Salvar, no topo da página do provedor.
5

Automação total (opcional)

Se quiser automação total, ative também Habilitar para todos os tickets: a IA passará a processar e responder automaticamente os atendimentos, sem necessidade de ativação manual ticket a ticket. No ChatGPT, a opção liga o ChatGPT nos atendimentos novos e nos que estão em andamento dos canais que têm API Key; canal sem API Key fica sem ChatGPT. Atendimento com Agente de IA não muda: o agente segue respondendo, e desligar esta opção também não o desliga.
6

Passo final obrigatório: vincule ao canal

Vá até o menu Canais e insira as credenciais (API Keys/Tokens) dentro das configurações de cada número/conexão que efetivamente usará aquela inteligência artificial. Habilitar o provedor em Bots IA é só o primeiro passo. A página do ChatGPT lembra isso no aviso A API Key fica em cada canal: a chave do ChatGPT vai no campo ChatGPT API Key da seção ChatGPT de cada canal (Administração → Canais, Editar). Chave salva depois vale para os atendimentos novos; num atendimento já aberto, ligue o ChatGPT na aba Linkar do painel de detalhes do atendimento. Canal com Agente de IA vinculado começa os atendimentos novos com o agente.
Benefícios e quando usar: ative os construtores de fluxo (Typebot, N8N, Dify, DialogFlow) quando quiser montar chatbots e automações visuais sem programar do zero. Ative os provedores de LLM quando quiser recursos de inteligência artificial nos atendimentos: descrição automática de imagens, geração de texto, e a base para o Copiloto de IA.
O painel Bots e IA também alimenta o Copiloto de IA, o assistente que apoia o Atendente em tempo real na tela de atendimento (sugestão de resposta, análise de sentimento, reescrita de mensagem, resumo de conversa, tradução inline e mais). O Copiloto tem sub-aba e fluxo de configuração próprios (Configurações → Bots IA → Copiloto de IA) e é detalhado por completo na página Agentes de IA do Guia da Plataforma; aqui basta saber que ele existe e depende dos provedores habilitados nesta tela.
Dicas e observações importantes:
  • 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.
Boa parte destas integrações (Z-API, UazAPI, Evolution, Wuzapi) são gateways não oficiais de WhatsApp: conectam números via QR Code em vez da API oficial da Meta. Elas são úteis quando a empresa ainda não migrou para o WhatsApp Business API oficial, mas carregam o risco inerente de qualquer solução não oficial (possibilidade de bloqueio do número pela Meta). Sempre que possível, avalie se a Integração Meta (canal oficial) não atende melhor à sua necessidade antes de optar por um gateway não oficial.
Nas páginas Z-API, UazAPI, Evolution API, Evolution Go, WuzAPI, Hub e GroqCloud pode aparecer o aviso Provedor global ativo. Ele indica que a plataforma já fornece uma configuração geral para essa integração: enquanto o aviso estiver ativo, ela tem prioridade e os campos preenchidos na página podem ser ignorados, então você não precisa instalar nem configurar esse serviço por conta própria. Nas páginas desta aba, chaves, tokens e senhas já salvos podem aparecer ocultos, com o aviso Valor salvo e oculto por segurança. Para trocar, digite um novo. Nas páginas Z-API, UazAPI, Evolution API, Evolution Go e WuzAPI, ao trocar a URL da API com a chave ainda oculta, digite a chave de novo: a tela avisa Ao trocar o endereço, digite o token de novo. O token salvo nunca é enviado a um endereço novo.
Quem usa: Administrador.O que é: página que unifica dois canais de BSP (Business Solution Providers, provedores de solução de negócio homologados pela Meta para operar contas WhatsApp Business API) em abas separadas: 360dialog e Gupshup. Cada BSP tem sua própria sub-navegação para Canais, Templates e Credenciais.
Integração em beta: os canais BSP (Dialog360 e Gupshup) ainda estão em fase de testes e ajustes, sem previsão de homologação definida; a equipe responsável trabalha continuamente em correções.
Aba Dialog360, passo a passo:
  1. Acesse Configurações → Integrações → BSP e selecione a aba Dialog360.
  2. Em Canais, veja a lista de canais WhatsApp Business já conectados via 360dialog (colunas: Nome, Channel ID, Telefone, Status, Qualidade, Ações).
  3. 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.
  4. Em Templates, clique em + Novo Template e preencha:
O campo Prévia mostra como a mensagem ficará antes de enviar para aprovação da Meta.
  1. 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.
Aba Gupshup, passo a passo:
  1. Selecione a aba Gupshup.
  2. 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.
  3. 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.
  4. 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).
Benefícios e quando usar: os canais BSP são uma alternativa à conexão direta via Meta (Integrações Meta) para empresas que já operam ou preferem operar através de um parceiro homologado 360dialog ou Gupshup: por exemplo, quando a empresa já tem contrato com um desses BSPs por outros motivos (preço, suporte local, recursos específicos).Dicas e observações importantes:
  • Partner Account x Customer Account: uma Partner Account (criada em hub.360dialog.com ou partner.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.
Quem usa: Administrador (configuração). Supervisores e o time de marketing se beneficiam diretamente dos relatórios de atribuição de anúncios.O que é: ferramenta que identifica e mensura a eficácia dos anúncios pagos, atribuindo as mensagens recebidas no PanÐá Zap a campanhas específicas do Meta Ads (Facebook/Instagram) e gerando relatórios para o Google Analytics 4 (GA4). O sistema captura o parâmetro técnico 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.
  1. No menu principal, clique em Configurações → Integrações e, no submenu lateral esquerdo, clique em Conversões Ads.
  2. Na aba Configurações, clique em + Nova credencial para cadastrar as chaves de acesso:
  1. 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 (ou Lead) 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 como qualify_lead ou generate_lead para fins de relatório no Analytics.
    • Opcionalmente, informe Valor (opcional) e Moeda, e mantenha Ativo ligado.
  2. 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 ID quando 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.
  3. 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.
  4. 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).
  5. 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.
Acompanhe os envios na aba Vendas (Vendas enviadas à Meta). A tabela mostra Data da venda, Oportunidade, Contato, Valor, Canal, Anúncio, Status e Ações. Filtre por Status e pelo período (De e Até, pela data da venda) e clique em Buscar (Limpar desfaz os filtros). Clique no status para ver a explicação e os detalhes da resposta da Meta. Quando há vendas recusadas, um aviso acima da tabela explica o problema e os passos para corrigir.O botão Reenviar (coluna Ações) fica disponível por até 7 dias depois da venda; depois disso ele aparece bloqueado, com o aviso A Meta só aceita vendas de até 7 dias atrás. Numa venda Não confirmada, ele pede confirmação antes (Reenviar venda não confirmada?, botão Reenviar mesmo assim). A venda cuja oportunidade foi excluída mostra Oportunidade excluída e não pode ser reenviada.Benefícios e quando usar: essencial para empresas que investem em anúncios “Clique para o WhatsApp” no Meta Ads e querem saber, com precisão, quais campanhas realmente geram conversas e vendas, e não apenas cliques.
Limitação de atribuição: o rastreamento não funciona se o anúncio enviar o cliente para um site ou landing page intermediária antes do WhatsApp: quando isso acontece, o parâmetro original do anúncio (Click ID) se perde, impossibilitando a atribuição direta nesta página.
Dicas e observações importantes:
  • 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.
Quem usa: Administrador, normalmente em conjunto com quem cuida das automações externas (n8n, Make, etc.).O que é: tela para configurar URLs de webhook que integram o PanÐá Zap a ferramentas externas, recebendo notificações automáticas sempre que eventos relevantes ocorrem na plataforma, sem precisar programar contra a API “na unha”.
  1. Acesse Configurações → Integrações → Webhooks.
  2. Ative o toggle Ativar webhook.
  3. Informe a URL do Webhook: o endereço público, em HTTPS, que receberá as requisições POST com os dados dos eventos.
  4. 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.
  5. Clique em Salvar.
  6. 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.
  7. Clique em Salvar novamente.
Benefícios e quando usar: use ferramentas como n8n ou Make para receber, filtrar e automatizar ações com base nos eventos enviados pelo PanÐá Zap: por exemplo, registrar automaticamente em uma planilha todo novo canal criado, ou notificar um grupo interno quando um usuário for cadastrado.Dicas e observações importantes:
  • 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-opportunity e delete-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ém contact-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.
Quem usa: Administrador (configuração). Atendentes e Supervisores recebem as conversas do widget normalmente, como qualquer outro ticket.O que é: tela para configurar o widget de Webchat, que incorpora um chat ao vivo diretamente no site da empresa. As mensagens dos visitantes chegam em tempo real na plataforma como atendimentos normais.
  1. Certifique-se de que já existe um canal do tipo Webchat instalado e conectado (pré-requisito).
  2. 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.
  3. Em Canal Webchat, selecione a sessão Webchat que receberá os atendimentos vindos do site.
  4. Se desejar, marque Habilitar botões de menu (#MENU): quando ativo, mensagens no formato #MENU são renderizadas como botões clicáveis no widget.
  5. Clique em Gerar Widget.
  6. 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).
  7. 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.
Formas de uso: a seção Formas de uso mostra as duas opções do canal selecionado:
  • 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.
Com o link direto ativo, dá para personalizar a página pública (o código de incorporação mantém o visual padrão), e depois clicar em Salvar:
  • 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).
A Pré-visualização mostra a página em modo Rascunho (suas alterações antes de salvar) ou Publicada (o que o visitante vê).Benefícios e quando usar: ideal para empresas que querem oferecer atendimento em tempo real diretamente no site institucional ou loja virtual, sem depender apenas do WhatsApp: os visitantes conversam pelo próprio site e a conversa entra na mesma fila/painel usado para os demais canais.
Ao regenerar o Token de Autenticação (ícone de renovar, ↺), todos os widgets já instalados nos sites param de funcionar imediatamente: será necessário substituir o código em cada site onde o widget está ativo.
Dicas e observações importantes:
  • 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.
Quem usa: Administrador (conexão das contas). Supervisores e Atendentes usam a agenda integrada no Funil de Vendas e no Chat Flow.O que é: integração que conecta uma ou mais contas Google ao PanÐá Zap para sincronizar agendas em tempo real. Depois de conectada, é possível criar e visualizar eventos do Google Calendar diretamente pelo sistema, vincular compromissos ao funil de vendas e automatizar agendamentos via chatbot.
  1. 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.
  2. Acesse Configurações → Integrações → Google Calendar e clique em + Nova configuração.
  3. Dê um Nome para identificar a integração (ex.: “Meu Calendário”).
  4. 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.
  5. 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).
  6. 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.
  7. Clique em Salvar.
  8. 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).
Depois de conectar (ajustes recomendados):
  1. 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.
  2. Teste a conexão: veja a última dica desta seção (Buscar e evento de teste).
  3. (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.
  4. (Opcional) Agendamento Público: em cada página, escolha a agenda em Agenda do Google desta página (ou Usar a agenda padrão).
Onde o Google Calendar pode ser usado no PanÐá Zap:Como criar as credenciais no Google Cloud:
  1. 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.
  2. 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.
  3. Ative a Google Calendar API (APIs e serviços → Biblioteca).
  4. 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.
  5. Em Acesso a dados, clique em Adicionar ou remover escopos, marque .../auth/calendar e .../auth/calendar.events e salve.
  6. 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.
  7. 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.
  8. 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.
Benefícios e quando usar: conecte o Google Calendar quando quiser que reuniões e compromissos combinados durante o atendimento (inclusive por chatbot) apareçam automaticamente na agenda real da empresa, e quando quiser vincular esses compromissos a oportunidades no funil de vendas.Dicas e observações importantes:
  • 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_mismatch logo 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.
Quem usa: Administrador.O que é: o Z-API é um serviço externo pago e independente do PanÐá Zap, que permite conectar números de WhatsApp via QR Code (API não oficial). Nesta página o Administrador cadastra as credenciais globais da sua conta Z-API, habilitando a criação de canais desse tipo.
  1. Contrate um plano diretamente em z-api.io e obtenha sua Global Key. O Z-API é pago e independente do PanÐá Zap.
  2. Acesse Configurações → Integrações → Z-API.
  3. 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.
  4. As alterações são salvas automaticamente ao sair do campo.
  5. 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.
Benefícios e quando usar: alternativa ao WhatsApp oficial para empresas que preferem conexão via QR Code, com suporte comercial de um provedor terceiro pago.Dicas e observações importantes: a partir do momento em que o canal é criado, as mensagens recebidas nesse número passam a chegar como tickets normais no PanÐá Zap.
Quem usa: Administrador.O que é: o UazAPI é um serviço self-hosted que permite conectar números de WhatsApp via QR Code (API não oficial). Nesta página o Administrador cadastra as credenciais da própria instalação UazAPI para habilitar a criação de canais.
  1. 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.
  2. Acesse Configurações → Integrações → UazAPI.
  3. 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).
  4. As alterações são salvas automaticamente ao sair do campo.
  5. 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.
Benefícios e quando usar: indicado para empresas que já têm (ou pretendem manter) sua própria infraestrutura de gateway WhatsApp não oficial, com controle total sobre o servidor.Dicas e observações importantes: as sessões UazAPI são gerenciadas em Configurações → Sessões: cada sessão corresponde a um número de WhatsApp, autenticado ao escanear o QR Code gerado.
Quem usa: Administrador.O que é: a Evolution API é uma solução open source que permite conectar números de WhatsApp via QR Code (API não oficial). Nesta página o Administrador cadastra as credenciais globais da própria instalação Evolution para habilitar a criação de canais.
  1. 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).
  2. Acesse Configurações → Integrações → Evolution API.
  3. 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 .env da Evolution, variável APP_ADMIN_TOKEN).
  4. 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.
  5. Vá em Canais para adicionar uma nova instância e conectar um número de WhatsApp via QR Code.
Benefícios e quando usar: opção open source para quem já opera ou quer operar sua própria infraestrutura de gateway não oficial de WhatsApp.
A Evolution API é um software de terceiros, de código aberto. Todo o processo de instalação, configuração e manutenção do servidor é de inteira responsabilidade do assinante; o suporte do PanÐá Zap não cobre problemas relacionados à Evolution API em si (apenas a integração dentro do painel).
Quem usa: Administrador.O que é: página da Evolution Go API, outra opção para conectar números de WhatsApp via QR Code (API não oficial), com os mesmos campos da Evolution API. Nela ficam as credenciais usadas para criar canais do tipo Evolution Go.
  1. Tenha uma instalação da Evolution Go API já rodando no seu servidor.
  2. Acesse Configurações → Integrações → Evolution Go.
  3. Preencha a URL da API (URL base da instalação) e a Global Key. As alterações são salvas automaticamente.
  4. 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.
  5. Crie o canal do tipo Evolution Go em Administração → Canais e leia o QR Code.
As páginas Evolution API e Evolution Go têm também a seção Passkey Linker (injector), com URL do injector e Segredo do injector. Ela só é necessária para conectar via WhatsApp Web sem QR Code e exige um serviço auxiliar rodando no mesmo servidor da sua Evolution. Assim como a Evolution API, a Evolution Go é software de terceiros: instalação e manutenção do servidor são de responsabilidade do assinante.
Quem usa: Administrador.O que é: o WuzAPI é uma solução open source que permite conectar números de WhatsApp via QR Code (API não oficial). Nesta página ficam a URL da API e a Global Key usadas para criar canais do tipo Wuzapi.
Se a página mostrar o aviso Provedor global ativo, a conexão WuzAPI já é fornecida pela configuração geral da plataforma: não é preciso instalar nada nem preencher os campos. Basta criar o canal do tipo Wuzapi em Administração → Canais e ler o QR Code.
Para usar uma instalação WuzAPI própria (quando o aviso acima não aparecer):
  1. Tenha uma instalação WuzAPI já rodando no seu servidor.
  2. Acesse Configurações → Integrações → WuzAPI.
  3. 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.
  4. 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.
  5. Crie o canal do tipo Wuzapi em Administração → Canais e leia o QR Code.
Benefícios e quando usar: mesma proposta do Evolution API: gateway WhatsApp não oficial open source.
Quando você usa uma instalação WuzAPI própria, instalação, configuração e manutenção desse servidor são de inteira responsabilidade do assinante, e o suporte do PanÐá Zap não cobre problemas relacionados diretamente a ele.
Quem usa: Administrador.O que é: integração com o Hub Notificame, serviço de terceiros. Nesta página (item Hub do menu lateral da aba Integrações) o Administrador informa o token de autenticação do Hub.
  1. Obtenha o token de autenticação no painel do Hub Notificame.
  2. Acesse Configurações → Integrações → Hub.
  3. Cole o token no campo Token Hub. As alterações são salvas automaticamente.
  4. Crie um canal do tipo Hub Notificame em Administração → Canais.
Benefícios e quando usar: use quando sua empresa já opera (ou deseja operar) o Hub Notificame como canal adicional.Dicas e observações importantes: se as mensagens pararem de ser entregues, atualize o token. Se a página mostrar o aviso Provedor global ativo, a integração já é fornecida pela configuração geral da plataforma.
Quem usa: Administrador (ativação). Toda a equipe de agentes da empresa passa a ver o Rocket.Chat no menu quando habilitado.O que é: esta página liga ou desliga o acesso ao Rocket.Chat (chat interno da equipe) para todos os agentes da sua empresa. Quando habilitado, o Rocket.Chat aparece no menu lateral da plataforma para todo o time.
  1. 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).
  2. Acesse Configurações → Integrações → Rocket.Chat.
  3. Ative o toggle Habilitar Rocket.Chat. A mudança é salva na hora, sem botão Salvar.
  4. A partir daí, os agentes acessam o chat interno em Comunicação e Marketing → Redes Sociais → Rocket.Chat, já logados na própria conta.
Com um servidor configurado, o card Servidor configurado mostra a URL do servidor, se há Admin User ID e Auth Token cadastrados (mascarados), o status e, quando for o caso, o selo Global (configuração geral da plataforma, que sua empresa não altera).Se o chat não abrir para algum atendente, a tela do Rocket.Chat mostra o motivo real do erro. Quando a empresa usa servidor próprio, o administrador confere tudo pelo botão Testar conexão em Configurações → Apps → Rocket.Chat (passo a passo e regras de conta na página Apps de Marketplace); se a configuração for a geral da plataforma, quem testa é a equipe que administra a plataforma.Benefícios e quando usar: ative quando quiser oferecer à equipe um canal de chat interno integrado à mesma plataforma de atendimento, sem precisar alternar entre sistemas diferentes.
Esta tela apenas liga/desliga a visibilidade do Rocket.Chat para os agentes: as credenciais do servidor propriamente dito (URL, tokens de administrador) ficam em uma tela separada, Apps → Rocket.Chat, que permite à sua empresa usar o próprio servidor Rocket.Chat em vez da configuração geral da plataforma. Essa tela de credenciais faz parte da aba Apps de Configurações, fora do escopo desta página.
Quem usa: Administrador (cadastro dos tokens). Atendentes passam a poder enviar SMS durante os atendimentos.O que é: tela para cadastrar os tokens dos provedores de SMS integrados ao PanÐá Zap. Com ao menos um token configurado, é possível enviar mensagens de texto via SMS durante os atendimentos.
  1. Acesse Configurações → Integrações → SMS.
  2. Escolha um ou mais dos três provedores suportados e informe o respectivo token:
  1. 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.
  2. As alterações são salvas automaticamente. É possível configurar mais de um provedor e escolher qual usar no momento do envio.
Benefícios e quando usar: use SMS para confirmações, notificações e atendimentos em canais onde o WhatsApp não está disponível ou não é a melhor opção (por exemplo, avisos curtos e diretos, ou contatos que não têm WhatsApp).Dicas e observações importantes:
  • 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.
Quem usa: Administrador (configuração). Atendentes se beneficiam da transcrição automática ao ouvir/ler áudios recebidos.O que é: o GroqCloud é um serviço de IA que transcreve automaticamente os áudios recebidos nos atendimentos, exibindo o texto transcrito abaixo do player de áudio em cada conversa.
  1. Crie uma conta em console.groq.com e gere uma API Key. O GroqCloud é um serviço de terceiros, pago e independente do PanÐá Zap.
  2. Acesse Configurações → Integrações → GroqCloud.
  3. 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).
  4. Informe a API Key gerada.
  5. Selecione o Idioma predominante dos áudios recebidos (configure corretamente para melhorar a precisão da transcrição).
  6. 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.
Benefícios e quando usar: essencial para equipes que recebem muitos áudios e precisam ler rapidamente o conteúdo sem precisar ouvir cada mensagem: acelera a triagem e ajuda em auditorias e buscas textuais posteriores.Dicas e observações importantes: as alterações desta tela são salvas automaticamente; o idioma configurado impacta diretamente a qualidade da transcrição, então ajuste-o ao idioma predominante do seu público. Depois de salva, a API Key pode aparecer oculta, com o aviso Valor salvo e oculto por segurança. Para trocar, digite um novo. Quando uma transcrição falha (de áudio recebido ou enviado), um aviso abaixo do cartão mostra a data e a hora da última falha dos últimos 7 dias: A última transcrição falhou: o GroqCloud recusou a chave de API (confira a API Key), A última transcrição falhou: o limite de uso do GroqCloud foi atingido (limite da sua conta no GroqCloud) ou A última transcrição falhou.
Quem usa: Administrador (configuração e testes). Supervisores usam para triagem automatizada antes de repassar a um Atendente humano.O que é: o VAPI é um serviço de voz com IA que permite realizar chamadas automatizadas, triagem de atendimentos e assistentes de voz configuráveis. Nesta página o Administrador conecta a conta VAPI ao PanÐá Zap e gerencia os assistentes e números de telefone disponíveis.
  1. Crie uma conta em vapi.ai e obtenha o token de API (há um botão Criar conta VAPI na própria tela, caso ainda não tenha uma conta).
  2. Acesse Configurações → Integrações → VAPI.
  3. Informe o Token da API VAPI.
  4. 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).
  5. 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.
Benefícios e quando usar: use o VAPI para triagem automática de atendimentos por voz antes de transferir para um agente humano, ou para montar assistentes especializados por tipo de atendimento (triagem, cobrança, suporte).Dicas e observações importantes:
  • 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.