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

# Visão geral

> Use a API oficial do WhatsApp pela Datafy trocando apenas a URL base e o token.

A Datafy funciona como um **espelho da Meta Cloud API**. Você chama os mesmos endpoints da documentação oficial da Meta, só que pela URL da Datafy e com o token gerado no nosso painel. Nós repassamos cada requisição para a Meta e devolvemos a resposta.

## Como usar

Nas suas chamadas, troque apenas a **URL base** e o **token**:

| Item | Meta Cloud API | Datafy |
| - | - | - |
| URL base | `https://graph.facebook.com/v21.0/` | `https://cloud.datafyapi.com.br/v1/` |
| Token | `Bearer <META_TOKEN>` | `Bearer sk_live_xxx` |

```bash theme={null}
# Antes: chamando a Meta diretamente
https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages

# Depois: via Datafy
https://cloud.datafyapi.com.br/v1/{PHONE_NUMBER_ID}/messages
```

O token `sk_live_xxx` é gerado no [painel da Datafy](https://app.datafyapi.com.br) quando você cria o canal. Ele **substitui completamente o token da Meta**, e sua credencial real nunca é exposta.

Para endpoints que não aparecem nesta referência, consulte a [documentação oficial da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api) e aplique a mesma troca.

> [!NOTE]
>
> Antes de integrar, veja como enviar o token em [Autenticação](https://developers.datafyapi.com.br/api-reference/whatsapp/visao-geral/autenticacao.md) e como buscar listas com várias páginas em [Paginação](https://developers.datafyapi.com.br/api-reference/whatsapp/visao-geral/requisicoes.md#paginação).

## Descubra seus IDs

Os endpoints da Meta usam IDs como `phone_number_id`, `waba_id` e `business_id`. Se você só tem o token da Datafy, chame o endpoint [Dados da conta](https://developers.datafyapi.com.br/api-reference/whatsapp/datafy/me.md) (`GET /me`) para descobrir esses valores:

```bash theme={null}
curl https://cloud.datafyapi.com.br/me \
  -H 'Authorization: Bearer sk_live_xxx'
```

## Exemplo: enviar uma mensagem de texto

```bash theme={null}
curl -X POST https://cloud.datafyapi.com.br/v1/{PHONE_NUMBER_ID}/messages \
  -H 'Authorization: Bearer sk_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999999999",
    "type": "text",
    "text": { "body": "Olá!" }
  }'
```

## Como esta referência está organizada

> [card] [Mensagens](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md)
>
> Enviar texto, mídia, localização, contato, botões, listas e carrossel.

> [card] [Endpoints Datafy](https://developers.datafyapi.com.br/api-reference/whatsapp/datafy/me.md)
>
> Recursos exclusivos da Datafy, como baixar mídia recebida e gerar handle para templates.

> [card] [Webhooks](https://developers.datafyapi.com.br/api-reference/whatsapp/webhooks/receber-eventos.md)
>
> Como receber os eventos do seu número e validar a assinatura.

> [card] [Requisições e limites](https://developers.datafyapi.com.br/api-reference/whatsapp/visao-geral/requisicoes.md)
>
> Códigos de erro, limites de requisição e rotas bloqueadas.


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