> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conecte e Gerencie Todos os Canais de Mensagem no PanÐá Zap

> Adicione e gerencie canais de WhatsApp (OAuth oficial, WABA e QR Code), Telegram, e-mail, webchat e marketplaces pelo painel administrativo do PanÐá Zap.

O PanÐá Zap suporta uma ampla variedade de canais de mensagem. Como administrador, você pode adicionar e gerenciar todos os canais em um só lugar, além de atribuir equipes e configurar comportamentos específicos por canal sem precisar acessar a interface do agente.

## Como acessar

Navegue até **Administração → Canais** no painel administrativo e clique em **Adicionar Canal** (ou no botão **+** em qualquer card de canal) para abrir o assistente de criação de canal.

***

## Tipos de canal

<Tabs>
  <Tab title="WhatsApp Oficial">
    As conexões oficiais do WhatsApp usam métodos aprovados pela Meta (OAuth ou Cloud API) e são adequadas para ambientes de produção. Seu número aparece no contato do WhatsApp dos seus clientes como uma conta comercial verificada.

    <AccordionGroup>
      <Accordion title="WhatsApp OAuth (WABA – modo de coexistência)">
        O WhatsApp OAuth conecta seu número por meio do fluxo de login oficial da Meta. No **modo de coexistência**, o número continua ativo no seu celular físico **e** dentro do PanÐá Zap ao mesmo tempo — você não precisa desvincular o número do aplicativo do WhatsApp.

        **Pré-requisitos:** o OAuth precisa ser habilitado para sua conta pelo suporte da plataforma PanÐá Zap antes que essa opção apareça.

        **Passos:**

        1. Em **Adicionar Canal**, escolha **WhatsApp OAuth**.
        2. Selecione o aplicativo Meta associado ao seu Gerenciador de Negócios.
        3. Clique em **Conectar via WhatsApp OAuth**.
        4. Complete o pop-up da Meta (faça login, selecione a conta do WhatsApp Business e o número de telefone, e conceda as permissões necessárias).
        5. No seu celular, abra o WhatsApp → **Aparelhos Conectados** → **Conectar um Aparelho**, depois escaneie o QR Code exibido no painel.
        6. Aguarde até que o card exiba o status **Conectado**.
      </Accordion>

      <Accordion title="WhatsApp Cloud API – aplicativo Meta próprio (WABA)">
        Use esta opção se sua empresa gerencia seu próprio aplicativo de desenvolvedor Meta no Meta Business Suite. Você informa as credenciais diretamente, tendo controle total sobre a configuração do seu WABA.

        **Pré-requisitos:** um aplicativo de desenvolvedor Meta com o produto WhatsApp Business API habilitado, e um token de acesso permanente (que nunca expira).

        **Credenciais necessárias:**

        | Campo                      | Onde encontrar                                             |
        | -------------------------- | ---------------------------------------------------------- |
        | Phone Number ID            | Meta Business Manager → WhatsApp → Números de telefone     |
        | WABA ID                    | Meta Business Manager → WhatsApp → Visão geral da conta    |
        | Token de Acesso Permanente | Meta Developer Console → App → Token de usuário do sistema |

        **Passos:**

        1. Escolha **WhatsApp Cloud API (aplicativo próprio)**.
        2. Cole o **Phone Number ID**, o **WABA ID** e o **Access Token**.
        3. Clique em **Salvar**. O PanÐá Zap registra o webhook automaticamente.
      </Accordion>

      <Accordion title="Dialog360 (BSP) — Beta">
        O Dialog360 é um Meta Business Solution Provider (BSP). Use-o se o seu WABA estiver registrado na plataforma Dialog360.

        **Passos:**

        1. Escolha **Dialog360**.
        2. Cole sua `D360-API-KEY` do painel do Dialog360.
        3. Clique em **Salvar**.

        <Note>A integração com o Dialog360 está atualmente em **beta**. Entre em contato com o suporte do PanÐá Zap caso encontre problemas.</Note>
      </Accordion>

      <Accordion title="Gupshup (BSP) — Beta">
        O Gupshup é outro BSP aprovado pela Meta. Use-o se o seu WABA for gerenciado pelo portal de parceiros da Gupshup.

        **Passos:**

        1. Escolha **Gupshup**.
        2. Informe seu **App ID** e **App Token** do painel da Gupshup.
        3. Clique em **Salvar**.

        <Note>A integração com o Gupshup está atualmente em **beta**. Entre em contato com o suporte do PanÐá Zap caso encontre problemas.</Note>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="WhatsApp Não Oficial (QR)">
    <Warning>
      Conexões não oficiais do WhatsApp têm risco de banimento da conta pela Meta. Use as conexões oficiais WhatsApp OAuth ou WABA para ambientes de produção.
    </Warning>

    As conexões não oficiais vinculam um número de telefone escaneando um QR Code no fluxo **Aparelhos Conectados** do WhatsApp. Elas não exigem uma conta de desenvolvedor Meta e são populares para casos de uso de baixo volume, mas a Meta pode restringir ou banir números que enviam grandes volumes por clientes não oficiais.

    **Provedores disponíveis:**

    | Provedor      | Observações                                       |
    | ------------- | ------------------------------------------------- |
    | Baileys       | Biblioteca open-source de WhatsApp em Node.js     |
    | ZAPO          | Cliente não oficial leve                          |
    | WebJS         | Automação do WhatsApp Web baseada em navegador    |
    | Evolution API | API multi-sessão auto-hospedada                   |
    | WUZAPI / Meow | API de WhatsApp em Go com sessões persistentes    |
    | Z-API         | Serviço brasileiro de API não oficial do WhatsApp |
    | Uazapi        | API não oficial multi-sessão                      |

    **Passos (iguais para todos os provedores baseados em QR):**

    1. Em **Adicionar Canal**, escolha o provedor de QR de sua preferência.
    2. Preencha o nome do canal e os campos específicos do provedor (por exemplo, URL do servidor para a Evolution API, ID da instância para a Z-API), depois clique em **Salvar**.
    3. No card do canal, clique em **Novo QR Code**.
    4. Abra o WhatsApp no seu celular → **Aparelhos Conectados** → **Conectar um Aparelho**, depois escaneie o QR Code exibido no painel.
    5. Aguarde até que o status do card mude para **Conectado** (geralmente entre 10 e 30 segundos).

    <Note>Se o QR Code expirar antes de você escaneá-lo, clique em **Novo QR Code** novamente para gerar um novo.</Note>
  </Tab>

  <Tab title="Outros Canais">
    <AccordionGroup>
      <Accordion title="Telegram">
        Os canais do Telegram usam a API oficial de bots do Telegram.

        **Passos:**

        1. Abra o Telegram e envie uma mensagem para **@BotFather** → `/newbot`.
        2. Siga as instruções para nomear seu bot e receber um **Bot Token**.
        3. No PanÐá Zap, escolha **Telegram** e cole o Bot Token.
        4. Clique em **Salvar**. O PanÐá Zap configura o webhook automaticamente.
      </Accordion>

      <Accordion title="Webmail – Gmail (OAuth)">
        Conecte uma conta do Gmail usando o fluxo OAuth do Google para que o PanÐá Zap possa enviar e receber e-mails em seu nome.

        **Pré-requisitos:**

        * Um projeto no Google Cloud com a **Gmail API** habilitada.
        * Um Client ID e Client Secret OAuth 2.0.
        * Uma **Senha de App do Gmail** (necessária se a verificação em duas etapas estiver ativa na conta) para o envio via SMTP.

        **Passos:**

        1. Escolha **Webmail (Gmail)**.
        2. Clique em **Conectar com o Google** e conclua a tela de consentimento OAuth.
        3. Informe sua **Senha de App SMTP** quando solicitado para permitir o envio de mensagens.
        4. Clique em **Salvar**.
      </Accordion>

      <Accordion title="E-mail – IMAP/SMTP (qualquer provedor)">
        Conecte qualquer provedor de e-mail (Outlook, Yahoo, domínios personalizados etc.) usando credenciais padrão de IMAP e SMTP.

        **Campos necessários:**

        | Seção          | Campo   | Exemplo                        |
        | -------------- | ------- | ------------------------------ |
        | SMTP (saída)   | Host    | `smtp.exemplo.com`             |
        | SMTP           | Porta   | `587` (TLS) ou `465` (SSL)     |
        | SMTP           | Usuário | `voce@exemplo.com`             |
        | SMTP           | Senha   | Senha de app ou senha da conta |
        | IMAP (entrada) | Host    | `imap.exemplo.com`             |
        | IMAP           | Porta   | `993`                          |

        **Passos:**

        1. Escolha **E-mail (IMAP/SMTP)**.
        2. Preencha os campos de SMTP e IMAP acima.
        3. Clique em **Salvar**. O PanÐá Zap testa a conectividade e exibe **Conectado** em caso de sucesso.
      </Accordion>

      <Accordion title="Webchat (widget do site)">
        O Webchat incorpora um balão de chat ao vivo em qualquer site que você controle.

        **Passos:**

        1. Escolha **Webchat** e configure a aparência do widget (nome, cor, mensagem de boas-vindas).
        2. Clique em **Salvar**.
        3. Copie o trecho `<script>` gerado no card do canal e cole no `<head>` ou `<body>` do HTML do seu site.

        As conversas iniciadas pelo widget abrem como tickets atribuídos a este canal.
      </Accordion>

      <Accordion title="Hub NotificaMe">
        O Hub NotificaMe é um hub de parceiro terceirizado e pago que reúne **Instagram Direct**, **Facebook Messenger**, **webchat** e **e-mail** em um único conector. É necessário ter uma conta NotificaMe ativa antes de conectar.

        **Passos:**

        1. Escolha **Hub NotificaMe**.
        2. Informe sua **API Key** e **Hub ID** do NotificaMe.
        3. Selecione quais subcanais (Instagram, Messenger etc.) deseja ativar.
        4. Clique em **Salvar** e siga as próprias etapas de OAuth do hub para cada canal social.
      </Accordion>

      <Accordion title="Marketplace e Canais Sociais (Beta)">
        Os canais a seguir estão disponíveis em **beta**. Recursos e estabilidade podem mudar.

        | Canal         | Tipo                               |
        | ------------- | ---------------------------------- |
        | Mercado Livre | Mensagens de marketplace           |
        | OLX           | Mensagens de marketplace           |
        | LinkedIn      | Social / DMs                       |
        | YouTube       | Gerenciamento de comentários       |
        | TikTok        | Gerenciamento de comentários / DM  |
        | WooCommerce   | Mensagens de pedidos de e-commerce |
        | Nuvemshop     | Mensagens de pedidos de e-commerce |

        Cada integração tem seu próprio fluxo de OAuth ou chave de API. Selecione o canal em **Adicionar Canal** e siga as instruções na tela.
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

***

## Ações do card de canal

Depois que um canal é conectado, o card correspondente em **Administração → Canais** exibe um menu de três pontos (⋮) com as seguintes ações:

| Ação                         | Descrição                                                                                                                                                |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Editar**                   | Renomeia o canal, reatribui a uma equipe e ativa ou desativa recursos específicos do canal.                                                              |
| **Definir como padrão**      | Torna este canal o principal, usado para mensagens geradas pelo sistema.                                                                                 |
| **Fechar tickets em aberto** | Fecha em massa todos os tickets em aberto atualmente atribuídos a este canal.                                                                            |
| **Fechar tickets pendentes** | Fecha em massa todos os tickets pendentes atualmente atribuídos a este canal.                                                                            |
| **Excluir**                  | Remove permanentemente o canal e toda a sua configuração. Essa ação não pode ser desfeita.                                                               |
| **Revalidar Webhook**        | Registra novamente o webhook com o provedor. Disponível para: Evolution API, Hub NotificaMe, WUZAPI/Meow, Instagram, Facebook Messenger, UAZAPI e Z-API. |

***

## Recursos do canal

Ao editar um canal, você pode ativar ou desativar os seguintes recursos na seção **Recursos**:

| Recurso                                          | O que faz                                                                                                                          |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Distribuição automática**                      | Atribui automaticamente novos tickets recebidos a agentes que estão online no momento, equilibrando a carga de trabalho da equipe. |
| **Posição na Fila**                              | Envia aos clientes uma mensagem automática informando a posição atual deles na fila de atendimento.                                |
| **Avaliação automática de satisfação**           | Envia automaticamente uma pesquisa de CSAT (satisfação do cliente) quando um ticket é encerrado neste canal.                       |
| **Transcrição de áudio**                         | Converte mensagens de voz recebidas em texto, exibido diretamente na conversa do ticket.                                           |
| **Desativar integrações automáticas ao aceitar** | Pausa qualquer bot de IA ou fluxo de automação ativo em um ticket no momento em que um agente humano o aceita.                     |
| **Contingência**                                 | Mantém o canal conectado e saudável, mas pausa temporariamente todas as mensagens recebidas — útil para janelas de manutenção.     |

***

## Integrações de API e canais

<Note>
  Cada integração de API (configurada em **Configurações → API**) está vinculada a **um canal**. Para enviar mensagens programaticamente por vários canais, crie uma integração de API por canal e use o token correspondente em suas requisições.
</Note>