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

# Autenticação

> Envie o token da Datafy no header de todas as requisições.

## Token do canal

As requisições da API do WhatsApp usam o token do canal, `sk_live_xxx`, gerado no [painel da Datafy](https://app.datafyapi.com.br) quando você cria o canal. Envie o token **sempre no header** `Authorization`:

```http theme={null}
Authorization: Bearer sk_live_xxx
```

> [!WARNING]
>
> A documentação da Meta mostra exemplos com o token na URL (`?access_token=...`). **Na Datafy isso não funciona.** Sem o header, a requisição é recusada.

```bash Correto theme={null}
curl "https://cloud.datafyapi.com.br/v1/{WABA_ID}?fields=analytics" \
  -H 'Authorization: Bearer sk_live_xxx'
```

```bash Não funciona theme={null}
curl "https://cloud.datafyapi.com.br/v1/{WABA_ID}?fields=analytics&access_token=sk_live_xxx"
```

Um `access_token` enviado na URL é ignorado. A Datafy usa o token do header e envia a credencial real para a Meta por conta própria, sem expô-la.

Se o token estiver ausente ou inválido, a resposta é **`401`**. Se a assinatura da Datafy estiver inativa, é **`402`**. Veja todos os códigos em [Erros](https://developers.datafyapi.com.br/api-reference/whatsapp/visao-geral/requisicoes.md#erros-da-datafy).

## Token de conta

Os endpoints de [Administração](https://developers.datafyapi.com.br/api-reference/administracao/introducao.md), que criam e gerenciam canais, usam outro token: o **token de conta**, no formato `sk_acct_xxx`. Ele vale para a conta inteira e é gerado no painel, em [Minha conta](https://app.datafyapi.com.br/conta), na aba **Parceiros**.

```http theme={null}
Authorization: Bearer sk_acct_xxx
```

| Token | Onde é usado |
| - | - |
| `sk_live_` | Endpoints do WhatsApp, em um canal |
| `sk_acct_` | Endpoints de administração, em `/channels` |

A administração exige que a conta tenha uma assinatura ativa. Sem isso, a resposta é **`403`**.


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