--- title: "Tutorial: Conexão do Whatsapp via API Oficial" description: Com a Talkey, é possível conectar seus canais de atendimento diretamente à plataforma, permitindo que a assistente virtual interaja com seus clientes de forma automatizada e eficiente. Neste tutorial, utilizaremos o WhatsApp como exemplo de canal de integração, mostrando passo… url: "https://portal.voorks.ai/docs/tutorial-conexao-do-whatsapp-via-api-oficial/" updated: "2025-08-18" category: Canais --- # Tutorial: Conexão do Whatsapp via API Oficial Com a Talkey, é possível conectar seus canais de atendimento diretamente à plataforma, permitindo que a assistente virtual interaja com seus clientes de forma automatizada e eficiente. Neste tutorial, utilizaremos o WhatsApp como exemplo de canal de integração, mostrando passo a passo como realizar essa configuração de forma simples e rápida. --- ## 1. Conectando o Talkey com o Whatsapp 1. Na tela de painel de seu agente, clique na aba **Canais**. 2. Dentro de canais, escolha a opção **Whatsapp API Oficial**. ![](https://portal.talkey.ai/wp-content/uploads/2025/08/image-3-1024x304.png) 3. Com a opção **WhatsApp API Oficial** é necessário que você tenha realizado as configurações no painel da Meta antes dessa etapa.Para conectar esse canal basta informar o **Whatsapp Business Account ID, Whatsapp Access Token**e**Whatsapp Phone Number ID** e clicar em **Continuar**. ![](https://portal.talkey.ai/wp-content/uploads/2025/04/image-19.png) 4. Assim que preencher os campos, o seu canal estará conectado! ![](https://portal.talkey.ai/wp-content/uploads/2025/08/image-4-1024x619.png) --- ## 2. Como eu consigo essas informações? Mantenha-se sempre atento ao status do canal. Se estiver offline, significa que o WhatsApp não está mais conectado ao Talkey. Nesses casos, o sistema enviará um alerta por e-mail aos membros administrativos. ![](https://portal.talkey.ai/wp-content/uploads/2025/04/image-80-1024x615.png) 1. Crie o App e adicione o produto WhatsApp - Acesse **Meta for Developers** → **My Apps** → **Create App** → escolha o tipo **Business**, preencha os dados necessários e finalize. ![](https://portal.talkey.ai/wp-content/uploads/2025/08/Captura-de-tela-de-2025-08-18-15-05-50-1024x301.png) ![](https://portal.talkey.ai/wp-content/uploads/2025/08/Captura-de-tela-de-2025-08-18-15-06-10-1024x423.png) ![](https://portal.talkey.ai/wp-content/uploads/2025/08/Captura-de-tela-de-2025-08-18-15-06-26-1024x646.png) ![](https://portal.talkey.ai/wp-content/uploads/2025/08/Captura-de-tela-de-2025-08-18-15-07-01-1024x654.png) ![](https://portal.talkey.ai/wp-content/uploads/2025/08/image-5-1024x459.png) - No painel do App, em **Add products**, clique **Set up** em **WhatsApp**. Isso abre o fluxo “Getting Started/API Setup”.*[Documentação oficial meta](https://developers.facebook.com/docs/whatsapp/cloud-api/?utm_source=chatgpt.com)* 2. Adicione seu número de produção e obtenha o Phone Number ID dele Você precisa vincular um número comercial de verdade (celular ou fixo dedicado ao atendimento). **Via painel:** - Em **WhatsApp → API Setup**, use **Add phone number** e conclua a verificação (SMS/voz). Ao final, o **Phone Number ID** do seu número aparece na própria tela de **API Setup** (“From”). [Desenvolvedores do Facebook](https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/add-a-phone-number/?utm_source=chatgpt.com) 3. Encontre o WABA ID (WhatsApp Business Account ID) - Acesse **Meta Business** (Business Manager) → **Settings (engrenagem)** → **Accounts** → **WhatsApp Accounts** → selecione sua conta. O **WABA ID** aparece no painel dessa conta. [Desenvolvedores do Facebook+1](https://developers.facebook.com/docs/graph-api/reference/whats-app-business-account/?utm_source=chatgpt.com) 4. Gere um Access Token permanente (revogável) para produção O token temporário expira. Para produção, gere um token de longa duração por **System User**: 1. Em **Business Settings** → **Users → System Users**, **Add** um novo *System User* (role **Admin**). 2. Clique **Add Assets** e dê acesso ao seu **WhatsApp Account** e ao **App**. 3. Ainda no *System User*, clique **Generate New Token**, selecione seu **App**, marque as permissões: - `whatsapp_business_messaging` - `whatsapp_business_management` - (geralmente também `business_management`) 4. Gere e **guarde o token** com segurança (cofre/variáveis de ambiente). [Desenvolvedores do Facebook](https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/?utm_source=chatgpt.com) 5. Guia rápido: onde pegar cada coisa - **WABA ID** → Business Manager: **Settings → Accounts → WhatsApp Accounts** (selecionar a conta). [Desenvolvedores do Facebook](https://developers.facebook.com/docs/graph-api/reference/whats-app-business-account/?utm_source=chatgpt.com) - **Phone Number ID (produção)** → App **Dashboard → WhatsApp → API Setup** (no bloco “From” do número) **ou** via `GET /{WABA_ID}/phone_numbers`. [Desenvolvedores do Facebook+1](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-messages/?utm_source=chatgpt.com) - **Access Token** - **Temporário** → App **Dashboard → WhatsApp → API Setup/Getting Started**. [Desenvolvedores do Facebook](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-messages/?utm_source=chatgpt.com) - **Permanente (System User)** → **Business Settings → Users → System Users → Generate Token** (com os *scopes* acima). [Desenvolvedores do Facebook](https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/?utm_source=chatgpt.com) --- ## Conclusão Seguindo esses passos, você poderá conectar o Talkey em seu canal Whatsapp, facilitando a comunicação. Caso necessite de mais ajuda, consulte a documentação oficial ou entre em contato com o suporte do Talkey.