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

# Canais (WhatsApp, Telegram, Slack)

> Coloque seu agente para atender onde seus clientes já estão — com o iTeam cuidando da parte chata da configuração

Um **canal** é a porta de entrada do seu agente no mundo real: o número de WhatsApp da empresa,
o bot no Telegram, o workspace do Slack. Você configura uma vez e o agente passa a receber e
responder mensagens ali — com a mesma inteligência, conhecimento e segurança de sempre.

Os canais ficam em **Agentes → (seu agente) → aba Canais**.

## WhatsApp Oficial (API da Meta)

O canal mais usado — e o único que pede um pouco de configuração do lado da Meta. O iTeam
automatiza tudo que dá: gera o token de verificação, mantém a URL do webhook estável e, se você
informar o **WABA ID**, faz a inscrição do app na sua conta WhatsApp Business sozinho.

<Steps>
  <Step title="Crie o canal">
    Na aba **Canais**, clique em **Novo Canal**, escolha **WhatsApp (API Oficial)** e dê um nome.
  </Step>

  <Step title="Preencha os dados da Meta">
    * **Phone Number ID** — em *App Dashboard → WhatsApp → API Setup*.
    * **Access Token** — o token de acesso (de preferência um token de longa duração ou de System User).
    * **Verify Token** — o iTeam **gera um para você**; é só copiar.
    * **WABA ID** *(recomendado)* — o ID da sua conta WhatsApp Business, em
      *WhatsApp Manager → Configurações da conta*.
  </Step>

  <Step title="Cadastre o webhook na Meta">
    Copie a **URL do webhook** que o iTeam mostra no canal e cole em
    *App Dashboard → WhatsApp → Configuração → Callback URL*, junto com o Verify Token.
    Clique em **Verificar e salvar** — a verificação passa na hora.
  </Step>

  <Step title="Assine o campo messages">
    Ainda na configuração do webhook, em **Webhook fields**, clique em *Manage* e assine o campo
    **messages**. Sem isso a Meta aceita a URL mas não envia as conversas.
  </Step>
</Steps>

<Tip>
  **Por que informar o WABA ID?** Existe uma etapa invisível que costuma travar tudo: o app da Meta
  precisa estar **inscrito** na sua conta WhatsApp Business (WABA). Sem essa inscrição, o painel da
  Meta mostra o webhook verificado, a tela do iTeam mostra "Ativo"… e **nenhuma mensagem chega**,
  sem erro nenhum. Com o WABA ID preenchido, o iTeam faz essa inscrição automaticamente ao salvar o
  canal e mostra o resultado na tela ("app inscrito no WABA ✓"). É opcional — mas evita a causa
  número 1 de "configurei tudo certinho e não funciona".
</Tip>

<Warning>
  Se o canal está "Ativo" mas as mensagens não chegam, confira nesta ordem:
  o **WABA ID** está preenchido e com "✓ inscrito"? O campo **messages** está assinado nos
  Webhook fields? O **Access Token** não expirou?
</Warning>

## WhatsApp via QR Code

Para testar rápido ou usar um número pessoal: escaneie o QR code como no WhatsApp Web e pronto —
sem conta na Meta. Ideal para pilotos; para produção, prefira a API Oficial.

## Telegram

Crie um bot com o [@BotFather](https://t.me/BotFather), cole o **Bot Token** no canal e o iTeam
registra o webhook sozinho. É o canal mais rápido de configurar.

## Slack

Crie um app no Slack, informe **Bot Token** e **Signing Secret**, e cadastre a URL do webhook que
o iTeam gera. O agente responde em canais e mensagens diretas, com narração de progresso.

## Boas práticas

* **Narração** — em cada canal você escolhe se o agente narra o que está fazendo ("vou buscar…")
  ou responde só o resultado. Herda do agente por padrão.
* **Um canal, um agente dono** — o canal pertence a um agente, que responde por ele. Outros agentes
  podem participar como membros.
* **Segurança** — os tokens ficam criptografados; a URL do webhook contém um segredo próprio e não
  muda quando você edita o canal (editar o token não derruba a integração).