- Telegram e E-mail
- Webchat
- Redes Sociais e Marketplaces
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
Crie o canal no PanÐá Zap
Informe o Bot Token
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.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.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”). 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).
- Na busca superior, procure por “Gmail API” e clique em Ativar.
- 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.
- 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.readonlyhttps://www.googleapis.com/auth/gmail.sendhttps://www.googleapis.com/auth/gmail.modify
- 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.
Gerar as credenciais OAuth
- Em Google Auth Platform → Clientes, clique em Criar cliente.
- No tipo de aplicativo, escolha Aplicativo da Web e defina um nome.
- 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. - 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.
- 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.
Configurar o canal no PanÐá Zap
- 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.
- 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.
- 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.
- 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.
- 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.
Configurar o SMTP para envio de respostas
- 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. 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.
- 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.
- 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.
- 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).
- Salve as configurações. Ao editar o canal, os botões Testar SMTP e Verificar Status ajudam a confirmar o envio.
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
Configuração SMTP (envio)
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: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

