> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud API

> Conecte um número novo diretamente à API oficial do WhatsApp pelo painel da Datafy.

## Antes de começar

Tenha em mãos um número que **não esteja em uso no aplicativo do WhatsApp** e que consiga receber SMS, como um chip físico ou virtual. Você também precisa de um [Portfólio Empresarial](https://developers.datafyapi.com.br/guias/meta/portfolio/criar.md) na Meta.

Se você quer conectar o número que já usa no aplicativo WhatsApp Business, siga o guia de [Coexistência](https://developers.datafyapi.com.br/guias/meta/conexao/coexistencia.md).

## 1. Inicie a conexão

No [painel da Datafy](https://app.datafyapi.com.br), clique em **Conectar**. Uma janela do Facebook será aberta com a tela de boas-vindas.

Clique em **Continuar**.

![Tela de boas-vindas do Login do Facebook para Empresas, com os botões Cancelar e Continuar.](https://mintcdn.com/datafy/q5EgWQ3VyWRmoApU/images/conexao/cloud-api-1-boas-vindas.webp?fit=max\&auto=format\&n=q5EgWQ3VyWRmoApU\&q=85\&s=963ebdc69bf1227b9280a18eb2cba299)

## 2. Escolha o número

No campo **Telefone**, abra a lista:

* **Se o número já existe na sua conta do WhatsApp Business**, selecione-o na lista.
* **Se o número ainda não existe**, clique em **Insira um novo número de telefone** e digite o seu número.

Clique em **Avançar**.

![Lista de números de telefone do WhatsApp, com a opção Insira um novo número de telefone selecionada.](https://mintcdn.com/datafy/UdbsL1wBdV9L46SS/images/conexao/cloud-api-2-numero.webp?fit=max\&auto=format\&n=UdbsL1wBdV9L46SS\&q=85\&s=326b747e4e7e8c730288532888a4e701)

## 3. Selecione o portfólio e a conta do WhatsApp Business

Escolha em qual **Portfólio empresarial** o número será cadastrado.

Depois, no campo **Conta do WhatsApp Business**, escolha se quer:

* **Criar uma conta do WhatsApp Business** nova para esse número; ou
* **Adicionar o número a uma conta já existente** no portfólio.

Clique em **Avançar**.

![Tela para selecionar o Portfólio empresarial e a Conta do WhatsApp Business, com a opção Criar uma conta do WhatsApp Business.](https://mintcdn.com/datafy/q5EgWQ3VyWRmoApU/images/conexao/cloud-api-3-portfolio-waba.webp?fit=max\&auto=format\&n=q5EgWQ3VyWRmoApU\&q=85\&s=708afcb456ec077f10685a95aa7c5be0)

## 4. Confirme o código por SMS

A Meta envia um **código de verificação por SMS** para o número informado. Digite o código recebido e clique em **Avançar**.

![Tela Verifique seu número de telefone, com os campos para digitar o código de verificação recebido por SMS.](https://mintcdn.com/datafy/q5EgWQ3VyWRmoApU/images/conexao/cloud-api-4-codigo-sms.webp?fit=max\&auto=format\&n=q5EgWQ3VyWRmoApU\&q=85\&s=c3af96ee02b10c8176554b13a558bdc2)

## 5. Preencha os dados do número

Informe os dados que serão usados no perfil do número:

* **Nome:** o nome que aparecerá para seus clientes no WhatsApp.
* **Categoria:** a categoria que melhor descreve sua empresa.
* **Site:** o endereço do site da empresa.
* **Fuso horário:** o fuso horário da sua operação.

Clique em **Avançar**.

![Formulário com os campos Nome, Categoria, País, Site e Fuso horário do novo número.](https://mintcdn.com/datafy/q5EgWQ3VyWRmoApU/images/conexao/cloud-api-5-perfil.webp?fit=max\&auto=format\&n=q5EgWQ3VyWRmoApU\&q=85\&s=ae19fcba706274476123ac4fd0db3067)

> [!NOTE]
>
> Durante a conexão, a Meta pode enviar um **código de confirmação para o e-mail cadastrado na sua conta do Facebook**. Nesse caso, acesse esse e-mail e insira o código para continuar.

## 6. Conclua a conexão

Na tela final, clique em **Concluir**. Seu número estará conectado à API oficial do WhatsApp.

![Tela de conclusão informando que a conta está conectada, com a conta do WhatsApp criada e o botão Concluir.](https://mintcdn.com/datafy/q5EgWQ3VyWRmoApU/images/conexao/cloud-api-6-concluir.webp?fit=max\&auto=format\&n=q5EgWQ3VyWRmoApU\&q=85\&s=b264048d8276493ba8f5feac91e6421b)

## Próximos passos

Pronto — seu número já está disponível na **API oficial do WhatsApp**. Veja o que fazer a seguir para começar a enviar mensagens:

> [card] [Criar um template](https://developers.datafyapi.com.br/guias/whatsapp/conceitos/templates-de-mensagem.md)
>
> Para **iniciar** uma conversa com um cliente, você envia um template aprovado pela Meta.

> [card] [Janela de 24 horas](https://developers.datafyapi.com.br/guias/whatsapp/conceitos/janela-de-24-horas.md)
>
> Mensagens de serviço (texto livre) só valem **depois que o cliente te chama** — isso abre a janela de 24 horas.

> [card] [Meio de pagamento](https://developers.datafyapi.com.br/guias/meta/pagamento.md)
>
> A partir de **1º de outubro**, é preciso ter um pagamento cadastrado para enviar templates e mensagens de serviço.

> [card] [Coexistência](https://developers.datafyapi.com.br/guias/meta/conexao/coexistencia.md)
>
> Quer usar o mesmo número no app do WhatsApp Business e na API ao mesmo tempo? Veja como.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.