Telegram
Quem usa: AdministradorUm canal extremamente estável, que roda 100% na nuvem (sem depender de nenhum celular conectado), conectado através de um Bot Token oficial gerado pelo próprio Telegram, no assistente conhecido como BotFather.Crie o bot no BotFather
No Telegram, converse com o bot oficial @BotFather e crie um novo bot para a sua empresa, obtendo o respectivo Bot Token.
Crie o canal no PanÐá Zap
Em Administração > Canais > Adicionar Canal, crie um canal do tipo Telegram, seguindo o formulário genérico descrito em “Como Conectar um Canal”.
Informe o Bot Token
Informe o Bot Token obtido no BotFather no campo correspondente da tela de criação do canal.
Por rodar inteiramente na nuvem via API oficial do Telegram, o Telegram é um dos canais com menor necessidade de manutenção depois de configurado, e uma das conexões mais estáveis de toda a plataforma, por não depender de emulação de WhatsApp Web nem de celular ligado. Vale a pena oferecer o Telegram como canal alternativo para clientes que já usam esse aplicativo, especialmente em nichos internacionais ou mais técnicos, onde o Telegram é comum.
Webmail (Gmail)
Quem usa: AdministradorIntegração que centraliza a comunicação por e-mail de uma conta Gmail diretamente no PanÐá Zap. Com ela, a equipe recebe as mensagens na caixa de entrada unificada de atendimento e responde aos e-mails diretamente pelo painel, sem precisar abrir o Gmail à parte.Para que a integração funcione tanto no recebimento quanto no envio de respostas, é necessário configurar um aplicativo no Google Cloud Console e gerar uma Senha de App no Gmail.
Criar o aplicativo no Google Cloud Console
- Acesse o Google Cloud Console e faça login com a conta Google que deseja vincular.
- Crie um novo projeto e dê um nome a ele (ex: “PanÐá Zap Email”).
- Na busca superior, procure por “Gmail API” e clique em Ativar.
- Antes de criar as credenciais, configure a tela de permissão: no menu lateral, vá em Tela de consentimento OAuth.
- Selecione “Externo” (se aplicável), clique em Criar e preencha os dados obrigatórios (nome do app, e-mail de suporte).
- Depois de criar a tela de consentimento, publique o aplicativo em produção, clicando em Publicar App.
Gerar as credenciais OAuth
- No menu do Google Cloud, vá em Credenciais > Criar Credenciais > ID do cliente OAuth.
- No tipo de aplicativo, escolha Aplicativo da Web e defina um nome.
- Em “URIs de redirecionamento autorizados”, adicione a URL do seu frontend seguida do callback do Gmail (por exemplo:
https://app.seudominio.com.br/gmail_callback.html).
- Clique em Criar. O Google gera o ID do Cliente e o Client Secret: mantenha essa tela aberta para copiar os dados.
Configurar o canal no PanÐá Zap
- No painel Admin, vá em Canais e adicione um novo canal do tipo Webmail.
- Dê um nome ao canal (ex: “Suporte Gmail”) e salve o canal antes de prosseguir.
- Depois de salvar, clique em Editar no canal recém-criado e vá em Configurar OAuth.
- Uma tela do Google se abre: selecione a conta de e-mail desejada, conceda as permissões necessárias e conclua a autenticação.
- De volta à edição do canal, o status deve constar como Autenticado. Clique em Conectar.
A partir daqui, o canal já está apto a receber e-mails.Configurar o SMTP para envio de respostas
Para conseguir enviar respostas pelo painel de atendimento, é obrigatório configurar a saída (SMTP) usando uma Senha de App do Google.
- Acesse as configurações da sua Conta Google (myaccount.google.com).
- Na aba Segurança, confirme que a Verificação em duas etapas (2FA) está ativada.
- Na busca das configurações do Google, procure “Senhas de app”.
- Crie uma nova senha (nomeie como, por exemplo, “PanÐá Zap SMTP”): o Google gera uma senha de 16 letras.
- No PanÐá Zap, edite o canal de Webmail e preencha a configuração de SMTP: em Usuário, o endereço de e-mail remetente; em Senha, a senha de app de 16 letras gerada pelo Google (removendo os espaços entre as letras).
- Salve as configurações.
Se o sistema apresentar erro de autenticação ou falha ao enviar mensagens, exclua a senha de app anterior no painel do Google e crie uma nova; depois, basta atualizar a nova senha nas configurações do canal e salvar novamente.
E-mail (IMAP/SMTP)
Quem usa: AdministradorA conexão via IMAP/SMTP permite integrar qualquer provedor de e-mail externo (Outlook, Yahoo, Hostgator, Locaweb, servidores próprios etc.) ao painel de atendimento, diferente do Webmail (Gmail), que é específico para contas Google. Com essa configuração, o sistema recebe e-mails como tickets de atendimento e permite responder aos clientes diretamente pela interface de chat.Informações iniciais
Ao adicionar um novo canal, selecione o tipo Email (IMAP/SMTP). Preencha o Nome do Canal (ex: “E-mail Comercial”) e defina, se desejar, o toggle Canal Padrão (conta principal de envio de e-mails do sistema).
Configuração SMTP (envio)
Os dados variam conforme o provedor de e-mail: Configuração IMAP (recebimento)
Configurações avançadas
- Validar certificado TLS: mantenha ativo para garantir que o sistema verifique a autenticidade do servidor de e-mail.
- Keepalive / IDLE: mantém a conexão com o servidor sempre ativa, permitindo recebimento quase instantâneo.
- Assinatura (HTML): texto de assinatura anexado ao final de todos os e-mails enviados, aceitando formatação HTML (ex:
<p>Atenciosamente,<br/><b>Equipe de Suporte</b></p>).
Webhook do canal
A opção Habilitar Webhook do Canal, se ativada, dispara notificações para uma URL específica sempre que um novo e-mail é processado por esta conta.
- Confirme que o servidor de e-mail permite conexões externas nas portas configuradas (587, 465, 993); em caso de dúvida, consulte o suporte técnico do seu provedor de e-mail.
- Alguns provedores (como Outlook/Office 365) exigem a criação de uma “Senha de Aplicativo” quando a Autenticação de Dois Fatores (2FA) está ativa na conta.
- O tamanho de anexos enviados e recebidos por e-mail respeita o limite do próprio provedor de e-mail (geralmente entre 10 MB e 25 MB).
Webchat
Quem usa: AdministradorUm widget de chat ao vivo para instalar no site institucional da empresa (ou no site de um cliente). O visitante clica em um pequeno botão no canto da tela e conversa com a equipe diretamente pelo site, sem depender do WhatsApp, e todas as mensagens chegam normalmente na fila de atendimento do PanÐá Zap.Nas versões mais recentes da plataforma, criar um Webchat é feito em poucos cliques pela própria interface: não é mais preciso criar subdomínio, editar arquivos de configuração de servidor ou fazer qualquer procedimento técnico manual. Todo o serviço de back-end necessário é provisionado automaticamente ao clicar em Conectar.
Criar o canal de Webchat
- No menu, acesse Administração > Canais.
- Clique em Adicionar Canal.
- Selecione a opção Webchat.
- Dê um nome ao canal (ex: “Webchat”) e confirme. O canal é criado e aparece no painel como desconectado.
Conectar (provisionamento automático)
- No card do canal recém-criado, clique em Conectar.
- Aguarde: o back-end da plataforma provisiona o serviço automaticamente (não é mais necessário nenhum procedimento manual de servidor).
Gerar o widget
- Com o canal conectado, clique nos três pontinhos do card do canal.
- Selecione Gerar Widget.
- O sistema pergunta se você quer habilitar botões no menu do Webchat: com botões, as opções de um chatbot em formato de botão aparecem como botões clicáveis dentro do Webchat; sem botões, o menu aparece apenas como texto.
- Clique em Gerar Widget: o sistema baixa e exibe o código JavaScript para copiar.
Antes de instalar, use o botão Testar na própria tela de geração: ele abre uma prévia do Webchat funcionando; envie uma mensagem de teste e confira se ela chega na fila de “Pendentes” do atendimento.Instalar o código no site
O widget é um código JavaScript e, por padrão, vem sem as tags <script>. Antes de colar em qualquer bloco de HTML, adicione a abertura e o fechamento da tag ao redor do código:
- Em uma página específica (ex: Elementor): edite a página desejada, adicione um bloco de HTML e cole o código já dentro das tags
<script>. O botão de chat aparece somente nessa página.
- Em todo o site (plugin de cabeçalho/rodapé): para o chat aparecer em todas as páginas, use um plugin que injete código no rodapé do site, como o WPCode (antigo “Insert Headers and Footers”). Instale/ative o plugin, crie um snippet do tipo JavaScript, cole o código do widget dentro do
<script>, ative o snippet e escolha inserção automática (“Auto Insert”) no rodapé, para todo o site.
Resumo rápido da tela
Quando usar: um canal de atendimento próprio do site, independente do WhatsApp, útil tanto para o site institucional da própria empresa quanto para revender como serviço a clientes que têm site próprio.Problemas comuns e troubleshooting
Mensagem não envia, ícone fica girando (erro de CORS)
Ao inspecionar o console do navegador (F12), aparece um erro de CORS relacionado ao domínio do site. Isso indica um bloqueio de configuração no servidor de back-end para o domínio onde o widget foi instalado; nesse caso, contate o suporte técnico da plataforma, já que o ajuste depende de uma configuração de servidor, não de nada acessível pela tela do painel.
Código colado não funciona (aparece como texto na página)
O widget é JavaScript e vem sem as tags <script>; se colado sem essas tags, o navegador trata o conteúdo como texto puro. Solução: envolva o código com <script>...</script> antes de colar; em plugins de cabeçalho/rodapé, prefira criar um snippet do tipo JavaScript, não um bloco de HTML/Footer genérico.
Snippet não salva no plugin de rodapé
Alguns plugins bloqueiam tags <script> soltas no campo genérico de rodapé; a solução é criar um snippet do tipo JavaScript (em vez de HTML/Footer) e usar inserção automática no rodapé.
Botão do chat não aparece
Confirme que o canal está conectado no painel, use o botão Testar para validar o widget e verifique se o snippet ou bloco está ativo na página correta.
Hub NotificaMe (Facebook, Instagram, WebChat e E-mail)
Quem usa: AdministradorUma forma alternativa de conectar Facebook Messenger, Instagram Direct, Webchat (o Webchat oferecido pela própria Hub NotificaMe, distinto do Webchat nativo descrito na aba anterior) e E-mail ao PanÐá Zap, usando a API de uma plataforma parceira externa chamada Hub NotificaMe. Para usar esses canais é necessário primeiro criar uma conta e contratar um plano diretamente no site da Hub NotificaMe, já que o pagamento desse serviço é feito ao próprio fornecedor, e não à plataforma PanÐá Zap.Embora a Hub NotificaMe ofereça outros tipos de canal em seu próprio produto, apenas os quatro listados acima (Messenger, Instagram, Webchat e E-mail) são implementados e oficialmente suportados dentro do PanÐá Zap.
- Crie sua conta e contrate um plano no site da Hub NotificaMe. Verifique com o suporte da plataforma se há algum cupom de parceria disponível: quando existir, o campo para aplicá-lo normalmente aparece na tela de checkout, depois de escolher o plano e antes do pagamento.
- Com a conta da Hub NotificaMe ativa, volte ao PanÐá Zap e informe as credenciais/dados solicitados nas configurações do canal correspondente.
- Repita a conexão para cada canal desejado (Messenger, Instagram, Webchat da Hub, ou E-mail).
Recursos disponíveis para canais conectados via Hub NotificaMe: essas conexões compartilham as mesmas ferramentas avançadas já descritas na seção “Recursos do Canal” (mensagem de despedida, palavra-chave de fechamento automático, avaliação automática, transcrição de áudio, auto distribuição, desligamento automático de integrações externas ao abrir um ticket etc.). Além disso, canais conectados pela Hub NotificaMe podem ser integrados a uma lista ampla de motores de inteligência artificial e automação: ChatGPT, TypeBot, Dify, N8N, Ollama, LM Studio, Grok, Gemini, DeepSeek, Qwen e Claude.Quando usar: vale considerar a Hub NotificaMe quando a operação já usa (ou prefere usar) esse hub externo para centralizar Instagram, Messenger, Webchat e E-mail em um único contrato, ou quando alguma limitação das conexões nativas de Instagram/Messenger (por exemplo, a exigência de administrador direto da página do Facebook) tornar o caminho nativo inviável para aquele caso específico.Por depender de uma plataforma externa paga, qualquer instabilidade, limite de uso ou cobrança adicional segue os termos comerciais da própria Hub NotificaMe, e não da plataforma PanÐá Zap. Antes de contratar, confirme com o suporte quais dos quatro canais (Messenger, Instagram, Webchat, E-mail) realmente atendem à necessidade da sua operação, já que outros canais eventualmente oferecidos pela Hub NotificaMe fora dessa lista não têm suporte oficial dentro da plataforma.
Canais beta de marketplaces e redes sociais
Os canais abaixo (Mercado Livre, OLX, LinkedIn, YouTube, TikTok e WooCommerce) estão em fase beta. Todos são configurados por um Administrador em Canais > Adicionar Canal e seguem, de forma geral, o mesmo padrão: Identificação (Nome do Canal e toggle Canal padrão), Atribuições (ChatFlow, Fila, Usuário), seções avançadas (Mensagem de Despedida, ChatGPT, Webhook do Canal, Recursos do Canal) e conexão via OAuth com a respectiva plataforma. Cada um tem, porém, limitações específicas importantes, detalhadas nos itens abaixo.
Quem usa: AdministradorUm canal, em fase beta, que recebe as mensagens e perguntas de compradores feitas nos seus anúncios do Mercado Livre diretamente no PanÐá Zap, como tickets de atendimento. Cada nova interação de um comprador cria um ticket na fila configurada.Pré-requisito: é necessário ter as credenciais do Mercado Livre configuradas antes de criar o canal. Isso pode já estar liberado de forma global pela equipe da plataforma, ou pode ser configurado pelo próprio administrador do tenant em Configurações > Apps > Mercado Livre. Se a opção não estiver disponível, procure primeiro essa tela de Apps antes de acionar o suporte.
- Em Canais > Adicionar Canal, selecione o tipo Mercado Livre.
- Preencha a Identificação: Nome do Canal (ex: “Mercado Livre Principal”) e o toggle Canal padrão (usado para novos atendimentos sem canal definido).
- Configure as Atribuições: ChatFlow (bot) acionado quando um ticket deste canal é aberto, Fila que receberá os tickets, e Usuário específico como alternativa à fila.
- Nas seções avançadas, configure conforme necessário: Mensagem de Despedida (enviada ao encerrar o atendimento), ChatGPT (integração de IA para resposta automática nos tickets deste canal), Webhook do Canal (URL para notificações de eventos) e Recursos do Canal (mesma tabela de comportamento já descrita em “Como Conectar um Canal”).
- Depois de criar o canal, clique em Conectar e siga o fluxo de autenticação OAuth: você será redirecionado ao Mercado Livre para autorizar o acesso da sua conta de vendedor. Depois de autorizar, o canal fica com status Conectado e passa a receber mensagens como tickets.
Quando usar: essencial para lojistas que vendem no Mercado Livre e não querem perder perguntas e mensagens de pós-venda por estarem fora da plataforma de atendimento unificado.Mensagens enviadas após a finalização da compra (pós-venda) têm limite de 350 caracteres, imposto pela própria API do Mercado Livre; mensagens mais longas são rejeitadas, então oriente a equipe a ser objetiva nesse tipo de resposta.
Quem usa: AdministradorUm canal, em fase beta, que recebe diretamente no PanÐá Zap, como tickets de atendimento, as mensagens de compradores interessados nos seus anúncios da OLX.Pré-requisito: credenciais da OLX configuradas antes de criar o canal, de forma global pela equipe da plataforma ou pelo próprio administrador em Configurações > Apps > OLX.
- Em Canais > Adicionar Canal, selecione o tipo OLX.
- Preencha a Identificação (Nome do Canal, ex: “OLX Principal”, e o toggle Canal padrão) e as Atribuições (ChatFlow, Fila, Usuário), da mesma forma já descrita para o Mercado Livre.
- Configure as seções avançadas (Mensagem de Despedida, ChatGPT, Webhook do Canal, Recursos do Canal).
- Clique em Conectar e siga o fluxo OAuth: você será redirecionado à OLX para autorizar o acesso da sua conta de anunciante. Depois de autorizar, o canal fica Conectado e passa a receber mensagens como tickets.
Quando usar: relevante para quem anuncia produtos ou serviços na OLX e quer centralizar essas conversas junto com os demais canais de atendimento.
- Respostas apenas em texto: a API da OLX não permite envio de mídia (imagens, vídeos, áudios); todas as respostas enviadas pelo PanÐá Zap precisam ser texto puro, e tentativas de enviar mídia são rejeitadas.
- Tokens sem renovação automática: ao contrário do LinkedIn, os tokens da OLX não se renovam sozinhos. Quando o token expira, o canal fica com status desconectado e as mensagens param de chegar. Para reconectar, acesse Canais, localize o canal OLX e clique em Conectar novamente, refazendo o fluxo OAuth. Vale colocar essa verificação periódica na rotina do administrador.
Quem usa: AdministradorUm canal, em fase beta, que recebe os comentários feitos em posts da página da empresa no LinkedIn diretamente no PanÐá Zap, como tickets de atendimento.Pré-requisito: credenciais do LinkedIn configuradas antes de criar o canal, de forma global pela equipe da plataforma ou pelo próprio administrador em Configurações > Apps > LinkedIn.
- Em Canais > Adicionar Canal, selecione o tipo LinkedIn.
- Preencha a Identificação (Nome do Canal, ex: “LinkedIn Página Empresa”, e Canal padrão) e as Atribuições (ChatFlow, Fila, Usuário).
- Configure as seções avançadas (Mensagem de Despedida, ChatGPT, Webhook do Canal, Recursos do Canal).
- Clique em Conectar e siga o fluxo de autenticação OAuth: você será redirecionado ao LinkedIn para autorizar o acesso à página da empresa. Depois de autorizar, o canal fica Conectado e passa a receber comentários como tickets.
Quando usar: útil para empresas B2B que usam o LinkedIn como canal de relacionamento e querem monitorar e responder comentários nos posts da página sem precisar acompanhar manualmente pelo LinkedIn.Respostas são públicas: toda resposta enviada pelo PanÐá Zap aparece publicamente no LinkedIn, visível para qualquer pessoa que acesse o post. Oriente a equipe a responder de forma adequada ao contexto público da rede social, já que não é uma conversa privada como no WhatsApp.
O token do LinkedIn expira a cada 60 dias, mas é renovado automaticamente: diferente da OLX, nenhuma ação manual é necessária para manter a conexão ativa.
Quem usa: AdministradorUm canal, em fase beta, que conecta uma conta do YouTube ao PanÐá Zap para que comentários de vídeos cheguem como atendimentos. A conexão é feita via OAuth do Google.Pré-requisito: configure as credenciais OAuth do Google em Configurações > Apps > Google antes de criar o canal.
- Em Canais > Adicionar Canal, selecione o tipo YouTube.
- Preencha o Nome do Canal (identificação interna) e o toggle Canal padrão.
- Expanda as seções opcionais: Atribuições (fila e agente padrão para os atendimentos recebidos), Mensagem de Despedida (enviada ao encerrar o atendimento), Webhook do Canal (URL externa de notificações) e Recursos do Canal (funcionalidades adicionais habilitadas para este canal).
- Clique em Criar Canal. Depois de criado, autorize a conexão com a conta Google via OAuth.
Quando usar: interessante para empresas que investem em conteúdo em vídeo e recebem muitas perguntas nos comentários dos próprios vídeos, permitindo tratar esses comentários como qualquer outro ticket de atendimento.A gestão detalhada de comentários (visualizar e responder comentários específicos dos vídeos) acontece em uma ferramenta própria da área de atendimento, fora do escopo desta página; aqui é apenas onde o canal é criado e conectado.
Quem usa: AdministradorUm canal, em fase beta, que conecta uma conta do TikTok ao PanÐá Zap para que comentários de vídeos anunciados (Ads / Spark Ads) cheguem como atendimentos.Pré-requisito: configure as credenciais do aplicativo TikTok em Configurações > Apps > TikTok antes de criar o canal.
- Em Canais > Adicionar Canal, selecione o tipo TikTok.
- Preencha o Nome do Canal e o toggle Canal padrão.
- Expanda as seções opcionais: Atribuições, Mensagem de Despedida, Webhook do Canal e Recursos do Canal.
- Clique em Criar Canal. Depois de criado, autorize a conexão com a conta TikTok via OAuth.
Quando usar: relevante para empresas que investem em anúncios em vídeo no TikTok (Ads / Spark Ads) e querem tratar os comentários desses anúncios como tickets de atendimento.
- Apenas comentários de vídeos anunciados (Ads / Spark Ads) são recebidos; posts orgânicos não são suportados pela API do TikTok.
- Fase 1 da funcionalidade: as respostas a comentários dadas pela equipe são salvas internamente no PanÐá Zap, mas ainda não são enviadas de volta ao TikTok. Ou seja, hoje o canal funciona apenas como forma de centralizar e registrar os comentários recebidos; o envio efetivo da resposta ao TikTok está previsto para uma fase futura. Comunique essa limitação à equipe de atendimento para evitar a expectativa de que o cliente vai realmente ver a resposta no TikTok.
Quem usa: AdministradorUm canal, em fase beta, que recebe notificações de novos pedidos da loja WooCommerce como tickets de atendimento, permitindo que a equipe acompanhe e gerencie pedidos diretamente pelo painel.Pré-requisito: integração WooCommerce configurada antes de criar o canal, de forma global pela equipe da plataforma (se aplicável) ou pelo próprio administrador em Configurações > Apps > WooCommerce.
- Em Canais > Adicionar Canal, selecione o tipo WooCommerce.
- Preencha a Identificação (Nome do Canal, ex: “WooCommerce Loja Principal”, e Canal padrão).
- Configure as Atribuições: apenas Fila e Usuário estão disponíveis para este canal (não há opção de ChatFlow/bot, já que o canal não permite conversas).
- Em Configuração WooCommerce, informe a URL da Loja: a URL base da loja, que deve corresponder exatamente à URL cadastrada na integração em Configurações > Apps > WooCommerce.
- Configure as seções avançadas restantes (Mensagem de Despedida, Webhook do Canal, Recursos do Canal).
Quando usar: útil para lojas virtuais que querem que a equipe de atendimento seja avisada automaticamente de cada novo pedido, sem precisar checar o painel da loja separadamente.O WooCommerce é um canal de entrada apenas. Não é possível responder mensagens ou conversar com o cliente diretamente por ele: serve exclusivamente para receber notificações de pedidos. Para falar com o cliente sobre um pedido, use os dados recebidos no ticket para abrir um atendimento em outro canal (WhatsApp, e-mail etc.).
