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

# Canais

> Conecte seus agentes a canais de comunicação como WhatsApp e Widget

Canais são os pontos de contato entre seus agentes e seus usuários finais. Ao conectar um canal, o agente passa a responder automaticamente as mensagens recebidas naquele canal.

## Canais disponíveis

<Columns cols={3}>
  <Card title="WhatsApp API Oficial" icon="whatsapp" iconType="brands">
    Integração direta via Meta WhatsApp Business API.
  </Card>

  <Card title="Z-API" icon="whatsapp" iconType="brands">
    Integração com WhatsApp via plataforma Z-API.
  </Card>

  <Card title="Widget" icon="message">
    Chat incorporável em qualquer site.
  </Card>
</Columns>

***

## WhatsApp API Oficial

Integração direta com a **Meta WhatsApp Business API**. A conexão é feita via fluxo OAuth embutido — você não precisa inserir credenciais manualmente.

### Como conectar

<Steps>
  <Step title="Acesse os Canais do agente">
    Dentro do agente, vá na seção **Canais** e clique em **Configurar** no card do WhatsApp API Oficial.
  </Step>

  <Step title="Complete o fluxo de autorização">
    O Gennia abre o fluxo de conexão da Meta. Autorize o acesso à sua conta do WhatsApp Business.
  </Step>

  <Step title="Verifique a conexão">
    Após autorizar, você verá os detalhes da conexão: WABA ID, número de telefone, nome do negócio e status.
  </Step>
</Steps>

<Note>
  Você precisa de uma conta no **WhatsApp Business API** (via Meta Business Suite). A API é diferente do WhatsApp Business App — ela permite automação e é necessária para integrar com o Gennia.
</Note>

***

## Z-API

Alternativa para conectar ao WhatsApp via plataforma **Z-API**. Requer uma instância ativa no Z-API.

### Como conectar

<Steps>
  <Step title="Acesse os Canais do agente">
    Dentro do agente, vá na seção **Canais** e clique em **Configurar** no card do Z-API.
  </Step>

  <Step title="Insira as credenciais">
    Preencha os três campos:

    * **Instance ID** — ID da sua instância no Z-API
    * **Instance Token** — Token da instância
    * **Client Token** — Token do cliente
  </Step>

  <Step title="Conecte">
    Clique em **Conectar**. Após a conexão, você verá o status e o ID da instância.
  </Step>
</Steps>

***

## Widget

O Widget é um chat incorporável que você adiciona ao site do seu cliente com um snippet de código.

### Como configurar

<Steps>
  <Step title="Acesse os Canais do agente">
    Dentro do agente, vá na seção **Canais** e clique em **Configurar** no card do Widget.
  </Step>

  <Step title="Personalize a aparência">
    Na aba **Customize**, configure:

    * **Slug** — Identificador único para a URL do widget
    * **Cor do botão flutuante** — Cor do botão de chat no site
    * **Cor das mensagens do usuário** — Cor das bolhas de mensagem
    * **Posição do botão** — Esquerda ou direita da tela
    * **Placeholder** — Texto de dica no campo de mensagem
    * **Sugestões de mensagem** — Opções de resposta rápida pré-definidas
  </Step>

  <Step title="Pré-visualize em tempo real">
    Enquanto ajusta as configurações, a pré-visualização atualiza automaticamente.
  </Step>

  <Step title="Copie o código de incorporação">
    Na aba **Embed**, copie o snippet de código e cole no HTML do site do seu cliente.
  </Step>
</Steps>