Pular para o conteúdo principal
Além do WhatsApp e das redes sociais principais, o PanÐá Zap conecta uma série de outros canais de atendimento: Telegram, e-mail (via Gmail ou via IMAP/SMTP genérico), um widget de chat para o site (Webchat), a integração via Hub NotificaMe e um conjunto de canais em fase beta voltados a marketplaces, e-commerce e redes sociais (Mercado Livre, OLX, LinkedIn, YouTube, TikTok, WooCommerce e Nuvemshop). Todos esses canais aparecem no grupo Outros do campo Tipo de Canal, em Administração > Canais > Adicionar Canal, e usam o mesmo formulário do canal: Nome do Canal, Canal padrão, os campos próprios do tipo e as seções recolhidas (Atribuições, Mensagem de Despedida, Webhook do Canal, Recursos do Canal e outras, conforme o tipo). Quem cria os canais é o Administrador; o Supervisor e o Perfil Personalizado também acessam a tela quando a permissão está liberada para eles. Esta página detalha o que é específico de cada um.

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

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

Crie o canal no PanÐá Zap

Em Administração > Canais > Adicionar Canal, crie um canal do tipo Telegram, seguindo o formulário do canal.
3

Informe o Bot Token

Na seção Telegram do formulário, cole o token obtido no BotFather no campo Token do Bot (BotFather) e clique em Criar Canal. Se o cartão do canal ficar desconectado, clique em Conectar.
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.

Mensagens do convite do Telegram

Quem usa: quem edita canais (Administrador; Supervisor e Perfil Personalizado quando a tela Canais está liberada para eles)No cadastro do contato é possível gerar um link de convite para ligar o Telegram da pessoa ao cadastro. Quando alguém usa esse link, o bot do canal responde com uma mensagem, e esses textos podem ser ajustados por canal (cada bot do Telegram tem os seus). Para isso, abra Editar no canal Telegram, expanda a seção Telegram e vá até o bloco Mensagens do convite do Telegram. Esse bloco só aparece na edição do canal, não na criação.Cada campo aceita até 1000 caracteres. Deixe em branco para o bot usar o texto padrão (o texto padrão aparece como sugestão dentro do campo vazio). Para voltar ao padrão depois de personalizar, apague o texto do campo. As mensagens são gravadas junto com o canal, ao clicar em Salvar alterações.
Se o canal for salvo mas os textos não, aparece o aviso O canal foi salvo, mas não foi possível salvar as mensagens do convite do Telegram. Os demais ajustes do canal ficam gravados; abra o canal de novo e repita a alteração dos textos.

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

Criar o aplicativo no Google Cloud Console

  1. Acesse o Google Cloud Console e faça login com a conta Google que deseja vincular.
  2. Crie um novo projeto e dê um nome a ele (ex: “PanÐá Zap Email”). Em conta Google Workspace, escolha a organização da empresa em Recurso pai: só projeto dentro da organização pode usar o público Interno (passo 4).
  3. Na busca superior, procure por “Gmail API” e clique em Ativar.
  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 caixa de e-mail é 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. Em Adicionar escopos manualmente, cole os quatro escopos abaixo (um por linha), clique em Adicionar à tabela, confira se eles aparecem marcados, clique em Atualizar e depois em Salvar no fim da página:
    • https://mail.google.com/
    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/gmail.send
    • https://www.googleapis.com/auth/gmail.modify
  6. Se a empresa já tem um projeto no Google Cloud usado no Google Calendar do PanÐá Zap, pode usar o mesmo projeto: ative nele a Gmail API, acrescente os escopos do Gmail (mantendo marcados os do Calendar) e use no canal o mesmo Client ID e Client Secret da agenda. As URIs de redirecionamento cadastradas para a agenda servem também para o Gmail; nesse caso, pule o passo seguinte.
2

Gerar as credenciais OAuth

  1. Em Google Auth Platform → Clientes, clique em Criar cliente.
  2. No tipo de aplicativo, escolha Aplicativo da Web e defina um nome.
  3. Em URIs de redirecionamento autorizados, adicione o endereço exibido no campo Redirect URI do formulário do canal no PanÐá Zap (seção Configuração OAuth2 (Recomendado para Gmail), veja o passo seguinte) e também https://oauth.pandazap.com/callback.html, os dois completos. Copie exatamente o endereço mostrado no formulário.
  4. Clique em Criar e copie o ID do Cliente 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.
  5. 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.
3

Configurar o canal no PanÐá Zap

  1. Em Administração > Canais > Adicionar Canal, selecione o tipo Webmail (Gmail) e dê um nome ao canal (ex: “Suporte Gmail”). Os servidores do Gmail (envio e recebimento) já vêm preenchidos.
  2. Se já tiver a Senha de App (passo seguinte), abra também a seção Configuração SMTP (Envio) e preencha agora o Usuário (e-mail de autenticação) e a Senha de aplicativo: o botão Configurar OAuth2 salva o canal com tudo o que estiver preenchido, e o formulário fecha sozinho quando a autorização termina.
  3. Abra a seção Configuração OAuth2 (Recomendado para Gmail) e cole o Client ID e o Client Secret gerados no Google. Quando outra pessoa que não é Administrador abre o canal depois, o Client Secret salvo aparece mascarado e o ícone de cadeado explica: O valor salvo só aparece para administradores. Deixe o campo como está para manter o valor atual ou digite um novo.
  4. Clique em Configurar OAuth2. Se o canal ainda não tiver sido salvo, ele é criado nesse momento; a janela do Google se abre: selecione a conta de e-mail desejada, conceda as permissões necessárias e conclua a autenticação. Se a janela terminar com O login do Gmail expirou ou não é válido. Feche esta janela e conecte o Gmail de novo pela tela de canais., o login venceu ou não é válido: feche a janela e clique em Configurar OAuth2 de novo no formulário do canal.
    • Enquanto a janela do Google estiver aberta, não clique em Criar Canal: o canal já foi criado pelo botão Configurar OAuth2, e um novo clique cria um segundo canal.
    • Se o navegador bloquear a janela do Google, libere as janelas pop-up do painel, abra o canal em Editar e clique em Configurar OAuth2 de novo.
  5. Quando a autorização termina, a janela do Google e o formulário fecham e o canal conecta sozinho. Ao abrir o canal de novo em Editar, a seção mostra ✓ Access Token configurado. Se o cartão do canal não ficar conectado, clique em Conectar no cartão.
A partir daqui, o canal já está apto a receber e-mails.
4

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.
  1. Acesse as configurações da sua Conta Google (myaccount.google.com).
  2. Na aba Segurança, confirme que a Verificação em duas etapas (2FA) está ativada. Em conta Google Workspace, o administrador precisa deixar marcada a opção Permitir que os usuários ativem a verificação em duas etapas (admin.google.com → Segurança → Autenticação → Verificação em duas etapas), e o método exigido não pode ser Somente chave de segurança ou chave de acesso: nesse modo o Google não libera senhas de app.
  3. Abra Senhas de app: a opção fica no fim da página da Verificação em duas etapas e também abre direto pelo endereço myaccount.google.com/apppasswords.
  4. Crie uma nova senha (nomeie como, por exemplo, “PanÐá Zap SMTP”): o Google gera uma senha de 16 letras e mostra essa senha uma única vez.
  5. No PanÐá Zap, edite o canal de Webmail e abra a seção Configuração SMTP (Envio): em Usuário (e-mail de autenticação), informe o endereço Gmail; em Senha de aplicativo, a senha de 16 letras gerada pelo Google (removendo os espaços entre as letras).
  6. Salve as configurações. Ao editar o canal, os botões Testar SMTP e Verificar Status ajudam a confirmar o envio.
Como receber e responder e-mails na tela de atendimento: com a integração concluída, todo e-mail recebido na conta Gmail vinculada chega automaticamente na tela de Atendimentos do PanÐá Zap, gerando um novo ticket. Nos atendimentos de e-mail, o campo de digitação dá lugar ao botão Escrever email: ele abre a janela Novo email, com os campos Para, Assunto e Mensagem (obrigatórios), CC e CCO (vários endereços separados por vírgula) e Anexos. O assunto já vem preenchido com “Re:” e o último assunto da conversa, para manter o mesmo fio. Clique em Enviar email para responder. O mesmo vale para os canais de E-mail (IMAP/SMTP).Respostas automáticas e e-mails antigos: a saudação da fila, o fluxo (Chat Flow), a mensagem de ausência e os gatilhos de resposta de campanha valem para os e-mails recebidos por IMAP, POP3 e Gmail, a partir da conexão da conta (o ícone de ajuda ao lado de Configurar OAuth2, no Webmail, e de Host IMAP, no E-mail, traz este resumo). No Gmail, até 10 e-mails que já estavam na caixa entram no histórico sem resposta automática, e o e-mail que não puder ser gravado fica como não lido e é tentado de novo, até 3 vezes por hora, enquanto estiver entre os 10 mais recentes da caixa.Quando usar: ideal para empresas que já usam o Gmail (ou Google Workspace) como e-mail principal e querem que o atendimento por e-mail entre na mesma fila unificada dos outros canais.
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. Trocar a senha da conta Google cancela as senhas de app e também a autorização do Gmail: o canal para de enviar e de receber. Depois da troca, crie uma nova senha de app, atualize o canal em Editar e clique em Configurar OAuth2 de novo.

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

Informações iniciais

Ao adicionar um novo canal, selecione o tipo Email (IMAP/SMTP). Preencha o Nome do Canal (ex: “E-mail Comercial”) e ative, se desejar, Canal padrão (conta principal de envio de e-mails do sistema).
2

Configuração SMTP (envio)

Na seção Configuração SMTP (Envio), informe o Usuário (e-mail de autenticação) (ex: atendimento@empresa.com.br): ao sair do campo, ou ao clicar em Detectar, o sistema tenta preencher automaticamente os dados de SMTP e IMAP do seu provedor. Em seguida, informe a Senha de aplicativo: a senha da conta de e-mail ou uma senha de aplicativo gerada no painel do provedor (o ícone de ajuda do campo explica como criar uma). Os demais dados ficam em SMTP avançado, para conferir ou preencher manualmente:Depois de salvar, ao editar o canal aparecem os botões Testar SMTP e Verificar Status.
3

Configuração IMAP (recebimento)

Na seção IMAP (Recebimento):Depois de salvar, ao editar o canal aparece o botão Testar IMAP.Se o servidor de e-mail ficar na rede interna (um endereço que não é público na internet), o Testar IMAP e o Detectar recusam o endereço por segurança e mostram: Este servidor de e-mail fica na rede interna e o teste recusa esse endereço por segurança. Quem administra o servidor do sistema pode liberá-lo. Mesmo sem a liberação, o canal salvo com esse endereço pode receber normalmente: reinicie o canal e confira se os e-mails chegam. Para pedir a liberação, fale com o suporte do PanÐá Zap. Se o nome do servidor não for encontrado, a tela avisa Não foi possível encontrar este servidor de e-mail pelo nome. Confira o endereço digitado.
Senhas salvas: o valor salvo só aparece para administradores. Quando outra pessoa com acesso à tela de Canais edita o canal, os campos de senha (no Webmail, Client Secret e Senha de aplicativo; no E-mail, Senha de aplicativo e Senha IMAP) vêm mascarados: deixe-os como estão para manter a senha atual ou digite uma nova. Ao trocar o servidor de e-mail (SMTP ou IMAP) com os campos mascarados, digite de novo as senhas de envio e de recebimento; sem isso, o salvamento é recusado com o aviso Ao trocar o servidor de e-mail, digite de novo as senhas de envio e de recebimento.
4

Configurações avançadas

Na seção Avancado:
  • 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>).
5

Webhook do canal

Na seção Webhook do Canal, ative Habilitar Webhook do Canal para enviar notificações a uma URL de destino exclusiva deste canal, em paralelo ao webhook geral; com a opção Mensagens recebidas ligada, o webhook é disparado a cada mensagem (e-mail) recebida por este canal.
Quando usar: use este canal (em vez do Webmail Gmail) sempre que a empresa utilizar um provedor de e-mail diferente do Google, ou um servidor de e-mail próprio.
  • 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).