Pular para o conteúdo principal
A API de administração permite criar e gerenciar os canais de WhatsApp da conta por requisições, sem passar pelo painel. É voltada a quem integra a Datafy a um sistema próprio e precisa provisionar canais de forma automática.
Esta seção trata apenas de canais de WhatsApp. A administração de contas do Instagram terá documentação própria.

​
Token de conta

As operações de administração usam o token de conta, que é diferente do token de cada canal: Todas as requisições de administração exigem o token de conta no cabeçalho Authorization:
Sem o cabeçalho, ou com um token de canal no lugar do token de conta, a resposta é 401.

​
Gerar o token

  1. Acesse o painel da Datafy em Minha conta e abra a aba Parceiros.
  2. Na seção Token de API, clique em Criar token.
  3. Copie o token exibido.
O token é exibido uma única vez, no momento da criação. Depois disso, o painel mostra apenas o final dele, para identificação. Guarde-o no servidor, como variável de ambiente.

​
Regenerar o token

O botão Regenerar, na mesma seção, emite um token novo. A conta mantém apenas um token ativo: ao regenerar, o anterior deixa de funcionar imediatamente, e as integrações que o utilizam passam a receber 401 até serem atualizadas.

​
Assinatura

Os endpoints de administração funcionam apenas com a assinatura da conta ativa. A conta é assinante quando tem ao menos um canal ativo, seja de WhatsApp ou de Instagram. A tabela usa os mesmos valores do campo subscription, retornado em Listar canais: Para sair do período de teste, acesse o painel da Datafy, crie um canal e ative a assinatura dele. A partir desse momento a conta passa a ser assinante e os endpoints de administração ficam disponíveis. Quando a assinatura não permite o acesso, a resposta é 403.

​
Limite de requisições

Os endpoints de administração aceitam 120 requisições por minuto por token de conta, contadas à parte dos limites da API do WhatsApp. Acima disso, a resposta é 429.