Autenticação

Visão Geral

Para utilizar a API da Digitalizei é necessário gerar um token de acesso através da plataforma.

Todas as requisições autenticadas devem enviar este token no cabeçalho (Header) da requisição utilizando o esquema Bearer.

Gerando seu Token

O token pode ser gerado diretamente na plataforma Digitalizei.

Caminho

Configurações > Integrações > API

Após gerar o token, armazene-o em um local seguro.

Importante: o token concede acesso aos recursos da API associados à sua conta. Nunca compartilhe seu token publicamente.

Utilizando o Token

Após gerar o token, envie-o em todas as requisições através do cabeçalho:

Authorization: Bearer SEU_TOKEN

Exemplo

Authorization: Bearer pn_000000000000000000000000

Exemplo em cURL

curl --request GET \
--url https://api.wts.chat/crm/contact \
--header 'Authorization: Bearer SEU_TOKEN'

Exemplo em JavaScript

const response = await fetch(
  "https://api.wts.chat/crm/contact",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer SEU_TOKEN"
    }
  }
);

const data = await response.json();

console.log(data);

Exemplo para N8N

Ao utilizar um nó HTTP Request:

Headers

{
  "Authorization": "Bearer SEU_TOKEN"
}

Não é necessário enviar usuário e senha nas requisições da API.

Testando diretamente pela documentação

Você também pode realizar requisições diretamente através desta documentação.

Para isso:

1. Clique em Authorize na documentação.
2. Informe seu token.
3. Confirme a autenticação.
4. Utilize o botão Try It disponível nos endpoints.

Após a autenticação, todas as chamadas realizadas pela documentação utilizarão automaticamente o token informado.

Boas práticas de segurança

• Nunca exponha o token em aplicações frontend públicas.
• Não compartilhe o token em e-mails, chats ou documentos públicos.
• Utilize variáveis de ambiente para armazenar credenciais.
• Revogue imediatamente tokens comprometidos.
• Gere novos tokens periodicamente quando necessário.

Erros comuns

Token inválido

{
  "message": "Unauthorized"
}

Verifique se o token foi informado corretamente.

Header ausente

{
  "message": "Authorization header not found"
}

Certifique-se de enviar:

Authorization: Bearer SEU_TOKEN

Bearer ausente

❌ Incorreto

Authorization: SEU_TOKEN

✅ Correto

Authorization: Bearer SEU_TOKEN

Dúvidas frequentes

O token expira?

Consulte as configurações da sua conta e política vigente da plataforma.

Preciso gerar um token para cada integração?

Não necessariamente. Um mesmo token pode ser utilizado por múltiplas integrações, desde que respeitadas as políticas de segurança da sua organização.

Posso utilizar a API sem autenticação?

Não. Todos os endpoints protegidos exigem autenticação através de token Bearer.