# Whatsapp Oficial ### Indice 1. Pre-requisitos 2. Parte 1 - Criar conta no Meta Business 3. Parte 2 - Criar o WABA (WhatsApp Business Account) 4. Parte 3 - Configurar numero de telefone na Meta 5. Parte 4 - Conectar no MultiAgents.app 6. Como usar a integracao 7. Regra da Janela de 24 Horas 8. Solucao de Problemas *** ### 0. Pre-requisitos Antes de comecar, verifique se voce possui tudo listado abaixo: * [ ] Uma conta pessoal no Facebook (necessaria para acessar o Meta Business) * [ ] Um numero de telefone que **NAO esteja vinculado** ao WhatsApp pessoal ou WhatsApp Business App * [ ] Capacidade de receber SMS ou ligacao no numero escolhido (para verificacao) * [ ] Informacoes da empresa: nome, endereco, site (para verificacao do negocio na Meta) > **⚠️ Atencao sobre o numero de telefone** > > O numero que sera usado para o WhatsApp Official **nao pode estar registrado** em nenhum outro WhatsApp (pessoal ou Business App). Se o numero ja esta em uso, voce precisara desvincula-lo antes de prosseguir. > > Para desvincular: abra o WhatsApp no celular → Configuracoes → Conta → Apagar conta. Aguarde alguns minutos antes de registrar na API. \ > [Veja a documentação da Meta.](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup) *** ### 1. Criar conta no Meta Business #### 1.1 Acessar o Meta Business Acesse: ``` https://business.facebook.com/ ``` **Passo 1: Fazer login** 1. Clique em **"Log in with Facebook"** 2. Entre com suas credenciais do Facebook 3. Se voce ainda nao tem uma conta, clique em **"Create new account"** #### 1.2 Criar um Portfolio de Negocios (Business Portfolio) Apos o login, se voce ainda nao possui um portfolio de negocios, a Meta solicitara que voce crie um: **Passo 2: Criar Business Portfolio** 1. Clique em **"Criar conta"** ou **"Create Account"** 2. Insira o **nome da sua empresa** 3. Insira o **seu nome** (responsavel) 4. Insira o **e-mail comercial** da empresa 5. Clique em **"Enviar"** > **💡 Dica:** Use o nome oficial da empresa exatamente como aparece nos documentos. Isso facilitara a verificacao do negocio mais tarde. #### 1.3 Acessar as Configuracoes do Negocio Caminho de navegacao: ``` Meta Business Suite → Configuracoes → Configuracoes do negocio ``` Apos criar o portfolio, voce sera redirecionado ao **Meta Business Suite**. Para acessar as configuracoes avancadas: 1. No menu lateral esquerdo, clique no icone de **engrenagem (Configuracoes)** 2. Em seguida, clique em **"Configuracoes do negocio"** 3. Isso abrira o painel completo onde voce gerenciara contas WhatsApp, usuarios e permissoes 4. *** ### 2. Criar o WABA (WhatsApp Business Account) #### Fluxo de Criacao ``` Meta Business Suite → Configuracoes do Negocio → Contas WhatsApp → WABA Criado! ``` #### 2.1 Acessar o WhatsApp Manager Caminho de navegacao: ``` Configuracoes do negocio → Contas → Contas do WhatsApp ``` \ **Passo 1: Navegar ate Contas WhatsApp**
1. No painel de **Configuracoes do negocio**, no menu lateral esquerdo 2. Expanda a secao **"Contas"** 3. Clique em **"Contas do WhatsApp"** #### 2.2 Adicionar Conta WhatsApp Business
**Passo 2: Criar nova conta WABA** 1. Clique no botao **"Adicionar"** (botao azul no canto superior) 2. Preencha os dados solicitados: * **Nome da conta WhatsApp Business:** Nome identificador (ex: "Minha Empresa - Atendimento") * **Fuso horario:** Selecione o fuso horario da sua regiao (ex: `America/Sao_Paulo`) * **Moeda:** Selecione `BRL` (Real Brasileiro) 3. Clique em **"Criar"** > **✅ Resultado esperado:** Apos a criacao, sua conta WABA aparecera listada em "Contas do WhatsApp" no menu lateral. O **ID da conta WABA** sera exibido - anote este numero pois podera ser util. #### 2.3 Verificacao do Negocio (Recomendado) Caminho: ``` Configuracoes do negocio → Central de Seguranca ``` > **💡 Por que verificar?** > > A verificacao do negocio desbloqueia funcionalidades importantes: > > * Envio de mensagens em maior volume > * Acesso a recursos avancados da API > * Nome verificado exibido no perfil do WhatsApp > > Para verificar, acesse **Central de Seguranca** nas configuracoes do negocio e siga as instrucoes (pode exigir documentos como CNPJ, contrato social, etc). *** ### 3. Configurar Numero de Telefone na Meta
#### 3.1 Acessar o WhatsApp Manager Acesse diretamente: ``` https://business.facebook.com/latest/whatsapp_manager/ ``` Ou pelo caminho: ``` Meta Business Suite → Todos os ativos → WhatsApp Manager ``` **Passo 1: Abrir o WhatsApp Manager** 1. Acesse o **Meta Business Suite** 2. No menu lateral, procure por **"WhatsApp Manager"** ou **"Gerenciador do WhatsApp"** 3. Selecione a conta WABA que voce criou no passo anterior #### 3.2 Adicionar Numero de Telefone **Passo 2: Adicionar numero**
1. Dentro do WhatsApp Manager, clique na aba **"Numeros de telefone"** ou **"Phone numbers"** 2. Clique em **"Adicionar numero de telefone"** 3. Preencha as informacoes do perfil: * **Nome de exibicao:** Nome que aparecera no WhatsApp (ex: "Minha Empresa") * **Categoria:** Selecione a categoria do seu negocio * **Descricao:** Breve descricao da empresa (opcional) 4. Insira o **numero de telefone** com o codigo do pais (`+55` para Brasil) 5. Clique em **"Proximo"**

Apos adicionar o número, deverá informar os dados da empresa e verificar o número

#### 3.3 Verificar o Numero **Passo 3: Verificacao por SMS ou Ligacao** 1. Escolha o metodo de verificacao: **SMS** ou **Ligacao telefonica** 2. Clique em **"Enviar codigo"** 3. Insira o **codigo de 6 digitos** recebido 4. Clique em **"Verificar"**
> **✅ Numero configurado!** Apos a verificacao, o numero aparecera listado no WhatsApp Manager com o status **"Conectado"**. Agora voce esta pronto para conectar ao MultiAgents.app. > **🚨 Importante:** Se o numero ja estava em uso no WhatsApp pessoal, voce precisara primeiro **apagar a conta do WhatsApp** no aparelho e aguardar pelo menos **5 minutos** antes de tentar adiciona-lo na plataforma Meta. *** ### 4. Conectar no MultiAgents.app Acesse: ``` https://multiagents.app ``` *Tela de login do MultiAgents.app* #### 4.1 Acessar o Agente **Passo 1: Login e navegacao** 1. Acesse **** 2. Faca login com suas credenciais 3. No menu lateral, clique em **"Agentes" > "Agentes Principais" > "Na configuração do agente"** #### 4.2 Instalar a Ferramenta WhatsApp Official Caminho de navegacao: ``` Agentes → [Seu Agente] → Ferramentas → Instalar Ferramenta ``` **Passo 2: Adicionar a ferramenta** 1. Dentro do agente, acesse a aba **"Ferramentas"** 2. Clique em **"Instalar Ferramenta"** ou no botao **"+"** 3. Na lista de ferramentas disponiveis, procure por **"WhatsApp Official"** 4. Clique em **"Instalar"** 5. ```
``` #### Fluxo de Instalacao ``` Login no MultiAgents → Selecionar Agente → Aba Ferramentas → Instalar WhatsApp Official ``` *** ### 5. Configurar a Ferramenta via OAuth #### 5.1 Iniciar a Conexao OAuth **Passo 1: Conectar via OAuth** 1. Apos instalar a ferramenta WhatsApp Official, clique nela para abrir as configuracoes 2. Voce vera a opcao **"Conectar via OAuth"** ou **"Conectar com Meta"** 3. Clique neste botao - uma janela popup da Meta sera aberta
#### 5.2 Autorizar no Meta **Passo 2: Autorizar permissoes** Na janela popup do Meta: 1. Faca login com a **mesma conta do Facebook** usada para criar o Business Portfolio 2. Revise as **permissoes solicitadas** (gerenciamento de mensagens WhatsApp, leitura de perfil do negocio, etc.) 3. Clique em **"Continuar"** ou **"Permitir"** > **⚠️ Bloqueador de popup:** Se a janela do OAuth nao abrir, verifique se o bloqueador de popups do navegador nao esta bloqueando a janela da Meta. Permita popups para o dominio `multiagents.app`.
#### 5.3 Selecionar a Conta Meta Business **Passo 3: Escolher o Business Portfolio** 1. Apos autorizar, voce retornara ao MultiAgents.app 2. Selecione a **conta Meta Business** (Business Portfolio) que voce criou 3. Se voce possui mais de uma conta, escolha a correta na lista suspensa #### 5.4 Selecionar a Conta WABA **Passo 4: Escolher a conta WABA** 1. Em seguida, selecione a **conta WABA** (WhatsApp Business Account) que voce criou no Passo 2 deste manual 2. A lista mostrara todas as contas WABA vinculadas ao seu Business Portfolio #### 5.5 Selecionar o Numero de Telefone **Passo 5: Escolher o numero configurado** 1. Por fim, selecione o **numero de telefone** que voce configurou e verificou no Passo 3 2. Clique em **"Salvar"** ou **"Conectar"**
#### Fluxo Completo da Conexao OAuth ``` Conectar via OAuth → Autorizar no Meta → Selecionar Meta Business → Selecionar WABA → Selecionar Numero ``` > **✅ Conexao estabelecida!** Se tudo ocorreu corretamente, a ferramenta WhatsApp Official mostrara o status **"Conectado"** e o numero de telefone vinculado. Agora seu agente esta pronto para enviar e receber mensagens pelo WhatsApp Official! *** ### 6. Como Usar a Integracao WhatsApp Official Com a integracao configurada, seu agente no MultiAgents.app tera acesso as seguintes funcionalidades: | Funcionalidade | Descricao | | ----------------------- | ---------------------------------------------------------------------------------------------------------------- | | **Receber Mensagens** | Todas as mensagens enviadas pelos clientes para o numero configurado serao recebidas automaticamente pelo agente | | **Responder Mensagens** | O agente pode responder mensagens dentro da janela de 24 horas | | **Enviar Midia** | Envio de imagens, documentos, audios e videos | | **Receber Midia** | Recebimento de fotos, audios, documentos e localizacao enviados pelos clientes | #### 6.1 Fluxo de Mensagens ``` Cliente envia mensagem → WhatsApp Official API → MultiAgents processa → Agente responde ``` *** ### 7. Regra da Janela de 24 Horas > **🚨 Regra Fundamental** > > O WhatsApp Business API (Official) possui uma **regra de janela de 24 horas** que e obrigatoria e imposta pela Meta. Entender essa regra e essencial para o bom funcionamento da integracao. #### 7.1 Como funciona | Situacao | O que pode fazer | Tipo de Mensagem | | ----------------------------------------------------- | ------------------------------------------- | ----------------------------------------------- | | **Dentro da janela** (24h apos ultima msg do cliente) | Enviar qualquer tipo de mensagem livremente | Mensagem de Sessao (gratuita ou custo reduzido) | #### 7.2 Janela Aberta (Dentro de 24h) Quando um cliente envia uma mensagem para o seu numero, uma **janela de 24 horas** e aberta. Durante esse periodo: * Voce pode enviar **qualquer tipo de mensagem** (texto, imagem, documento, etc.) * Nao e necessario usar templates * O custo e reduzido ou gratuito (dependendo da categoria) * Cada nova mensagem do cliente **reinicia o contador de 24h** #### 7.3 Janela Fechada (Apos 24h) Quando a janela de 24 horas expira sem nova mensagem do cliente: * Voce **NAO pode** enviar mensagens de texto livre * So e possivel enviar **Message Templates** pre-aprovados pela Meta * Templates precisam ser criados e aprovados previamente no WhatsApp Manager * Cada envio de template e **cobrado** pela Meta #### 7.4 Linha do Tempo ``` [00:00] 📩 Cliente envia mensagem → Janela ABERTA [00:00 - 24:00] ✅ Pode responder livremente → texto, midia, etc. [Apos 24:00] 🔒 Janela FECHADA → Apenas templates aprovados ``` #### 7.5 Boas Praticas * **Nao envie spam:** O WhatsApp monitora a qualidade das mensagens e pode restringir seu numero * **Mantenha a qualidade:** Respostas relevantes e uteis mantem o rating do numero alto * **Configure respostas automaticas:** Use o agente do MultiAgents para responder dentro da janela *** ### 8. Solucao de Problemas #### Erro: "Numero ja registrado em outro WhatsApp" **Solucao:** O numero precisa ser desvinculado do WhatsApp pessoal/Business App. No celular, abra o WhatsApp → Configuracoes → Conta → Apagar minha conta. Aguarde 5 minutos e tente novamente. *** #### Erro: "Popup do OAuth nao abre" **Solucao:** Desabilite o bloqueador de popups para o dominio `multiagents.app`. No Chrome: canto superior direito da barra de endereco → Permitir popups. *** #### Erro: "Nao aparece a conta WABA para selecionar" **Solucao:** Verifique se voce esta logando com a mesma conta do Facebook que possui permissao de admin no Business Portfolio. A conta WABA precisa estar vinculada ao mesmo portfolio. *** #### Erro: "Codigo de verificacao nao chega" **Solucao:** Tente o metodo alternativo (se usou SMS, tente ligacao e vice-versa). Verifique se o numero pode receber chamadas/SMS internacionais, pois o codigo vem de um numero estrangeiro. *** #### Erro: "Mensagens nao estao sendo recebidas" **Solucao:** Verifique se: * A ferramenta mostra status "Conectado" no MultiAgents * O webhook esta configurado corretamente (feito automaticamente pelo OAuth) * O numero mostra status "Conectado" no WhatsApp Manager da Meta *** #### Erro: "Nao consigo enviar mensagens apos 24h" **Solucao:** Isso e o comportamento esperado. Apos 24h, voce so pode enviar mensagens usando **Templates aprovados**. Crie e aprove templates no WhatsApp Manager da Meta. *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://multiagents.gitbook.io/multiagents-docs/documentacao-de-tools/readme/whatsapp-oficial.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.