Use este guia quando você precisar configurar, entender ou validar **Como conectar WhatsApp** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

Você pode gerenciar as conversas da sua conta comercial do WhatsApp diretamente da IAra. Para conectar seu número do WhatsApp, a IAra oferece suporte a dois métodos de integração:

* **Inscrição incorporada (recomendado)** – um fluxo guiado desenvolvido pela Meta que configura automaticamente seu número, webhooks e tokens.

* **Configuração manual** – uma opção avançada para provedores de tecnologia e casos em que a inscrição incorporada não pode ser usada.

Este guia oferece uma visão geral de ambos os métodos, suas diferenças e links para instruções detalhadas passo a passo.

## Pré-requisitos

* Um **desenvolvedor Meta (Facebook) ou conta comercial**

* Um **número de telefone válido** (ainda não vinculado a outro fluxo de inscrição incorporada do WhatsApp, a menos que esteja migrando)

* Um **espaço de trabalho IAra** com recurso WhatsApp ativado

## Etapa 1: vá para as caixas de entrada

1. Faça login em sua conta da IAra.

2. Navegue até **Configurações › Caixas de entrada › Adicionar caixa de entrada**.

<!-- iara-context-media:caixas-de-entrada-01-adicionar-caixa -->
**Na tela:** Comece em **Configurações > Caixas de entrada** e clique para adicionar uma nova caixa.

![caixas.](https://app.digi2b.com/storage/file/mokejijs7imik2bdhyqov0fqpp17)

## Etapa 2: Escolha seu método de configuração

Ao criar uma caixa de entrada do WhatsApp, você verá duas opções:

<!-- iara-context-media:widget-site-whatsapp-inbox-frame-002 -->
**Na tela:** Depois de escolher WhatsApp, revise a caixa criada e confirme se ela aparece na lista de canais.

![WhatsApp.](https://app.digi2b.com/storage/file/qys9aeepfbql74q81qwx2rh5y7hd)

* Redireciona você para o fluxo de inscrição incorporado do Meta.

* Você faz login com sua conta do Facebook, seleciona ou cria uma conta comercial do WhatsApp (WABA) e adiciona seu número de telefone.

* IAra recebe automaticamente o webhook, tokens e configuração do número de telefone.

Use esta opção se você:

* Adicionando um **novo número do WhatsApp**

* Procurando a **configuração mais rápida e sem configuração**

* Não é um provedor de tecnologia que integra seu próprio número

[Leia o guia completo sobre inscrição incorporada no WhatsApp]

### **Configuração manual**

* Você configura tudo através do Meta Developer Console.

* Requer geração de tokens, criação de um usuário do sistema, atribuição de ativos e configuração manual de webhooks.

* Você copia/cola o ID do número de telefone, o ID da conta comercial e a chave API na IAra.

Use esta opção se você:

* Um **provedor de tecnologia** integrando seu próprio número

* Reutilizando um número que **já está vinculado ao Embedded Signup**

* Confortável trabalhando com o painel Meta Developer

[Leia o guia completo sobre configuração manual]

---
## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.