Skip to main content
POST
/
api
/
auth
/
register
curl -X POST https://api.disparador.com/api/auth/register \
  -H "Content-Type: application/json" \
  -H "ACCESS_TOKEN: Bearer {admin_password}" \
  -d '{
    "name": "Minha Empresa LTDA",
    "email": "[email protected]",
    "password": "senha123"
  }'

{
  "accessToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tokenType": "Access",
  "companyId": 1,
  "companyName": "Minha Empresa LTDA",
  "companyEmail": "[email protected]",
  "blockedContactsEnabled": true,
  "pollCampaignsEnabled": true,
  "automationsEnabled": true,
  "automationLimit": 10,
  "expiresAt": null,
  "message": null
}
Este endpoint requer autenticação de administrador. Você precisa fornecer o token de administrador no header ACCESS_TOKEN.
Novo método de registro disponível! Empresas também podem ser criadas automaticamente ao contratar um plano através do checkout Stripe. Veja Contratar Plano para mais detalhes.
Após obter o access token da empresa, use-o no header X-Access-Token em todos os outros endpoints.

​
Métodos de Registro

Existem duas formas de registrar uma empresa no sistema:
  1. Via Token Admin (este endpoint) - Para parceiros e integradores com acesso administrativo
  2. Via Contratação de Plano - Usuários finais podem criar uma conta ao contratar um plano via Stripe

​
Diferenças entre os métodos:

MétodoToken AdminContratação de Plano
Requer senha adminSimNão
Requer pagamentoNãoSim
Tipo de registroadmin_passwordstripe_subscription
Acesso ao sistemaIlimitadoRequer assinatura ativa

​
Headers

​
Content-Type
string
required
Deve ser application/json
​
ACCESS_TOKEN
string
required
Token de administrador no formato: Bearer

​
Body Parameters

​
name
string
Nome da empresa (máximo 100 caracteres). Se não fornecido, será usado a parte antes do @ do email
​
email
string
required
Email da empresa. Deve ser um email válido e único no sistema
​
password
string
required
Senha da empresa. Deve ter pelo menos 6 caracteres
curl -X POST https://api.disparador.com/api/auth/register \
  -H "Content-Type: application/json" \
  -H "ACCESS_TOKEN: Bearer {admin_password}" \
  -d '{
    "name": "Minha Empresa LTDA",
    "email": "[email protected]",
    "password": "senha123"
  }'

​
Response

​
Campos Principais

​
accessToken
string
Token de acesso único da empresa para autenticação
​
tokenType
string
Tipo do token. Sempre retorna “Access”
​
companyId
number
ID único da empresa criada
​
companyName
string
Nome da empresa registrada
​
companyEmail
string
Email da empresa
​
expiresAt
string
Data de expiração do token. Sempre null (tokens não expiram)
​
message
string
Mensagem de erro. Null em caso de sucesso

​
Funcionalidades Habilitadas

​
blockedContactsEnabled
boolean
Se a funcionalidade de bloqueio inteligente está habilitada (padrão: true)
​
pollCampaignsEnabled
boolean
Se a funcionalidade de enquetes está habilitada (padrão: true)
​
automationsEnabled
boolean
Se a funcionalidade de automações está habilitada (padrão: true)
​
automationLimit
number
Limite de automações permitidas para a empresa (padrão: configurado no sistema)
{
  "accessToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tokenType": "Access",
  "companyId": 1,
  "companyName": "Minha Empresa LTDA",
  "companyEmail": "[email protected]",
  "blockedContactsEnabled": true,
  "pollCampaignsEnabled": true,
  "automationsEnabled": true,
  "automationLimit": 10,
  "expiresAt": null,
  "message": null
}

​
Validações

Email

  • Deve ser um email válido
  • Deve ser único no sistema
  • Máximo 100 caracteres

Senha

  • Mínimo 6 caracteres
  • Sem limite máximo
  • Armazenada com hash seguro

Nome

  • Opcional
  • Máximo 100 caracteres
  • Se vazio, usa parte do email

Token Admin

  • Obrigatório
  • Formato: Bearer
  • Configurado no servidor

​
Segurança

  • O token de administrador deve ser mantido em segredo
  • Nunca exponha o token de admin em código cliente
  • Use este endpoint apenas em ambientes seguros
  • Considere implementar rate limiting adicional

​
Após o Registro

1

Salve o Access Token

Armazene o token retornado de forma segura para uso futuro
2

Configure Webhooks

Configure os webhooks para receber notificações de eventos
3

Crie Instâncias

Crie instâncias do WhatsApp para começar a enviar mensagens
4

Teste a API

Use o endpoint /api/auth/me para verificar se tudo está funcionando

​
Próximos Passos

Fazer Login

Faça login com as credenciais criadas

Verificar Token

Valide o access token obtido