Como conectar WhatsApp

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.

Na tela: Comece em Configurações > Caixas de entrada e clique para adicionar uma nova caixa.

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

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

Na tela: Depois de escolher WhatsApp, revise a caixa criada e confirme se ela aparece na lista de canais.

• 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.