Como obter o token de integração

O token de integração é a chave que sua equipe técnica (ou sistemas externos) usa para chamar a API REST e o GraphQL da WhatsWave em nome da sua empresa.

O que você precisa

Planos sem acesso à API (por exemplo Free/Light, conforme o catálogo) não liberam o token. Faça upgrade se a opção estiver bloqueada. Veja Planos e limites se necessário.

Passo a passo

1. Entre no app com a empresa correta selecionada (troque em Empresas se precisar).
2. Abra Configurações → Chaves de API.
3. Na seção Integração, gere ou copie o token de integração.
4. Guarde o token em um gerenciador de secrets — não compartilhe em chats públicos nem commite no Git.

Como enviar nas requisições

Todas as chamadas autenticadas usam o header Bearer:

Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO

Exemplo com curl:

curl -s https://api.whatswave.com.br/health \
  -H "Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO"

Base de produção da API:

• https://api.whatswave.com.br
• (alternativo) https://service.whatswave.com.br

Documentação interativa (Swagger): service.whatswave.com.br/docs.

Company ID

O token de integração já carrega o company_id da empresa em que foi gerado. Em vários endpoints isso basta.

Quando o endpoint pedir company_id na query (ex.: listar boards), envie o UUID da empresa ativa. Você pode:

• Copiar o ID da empresa nas configurações / contexto da conta
• Ou listar boards e usar o company_id retornado em cada board

Segurança

• Trate o token como senha: quem tiver o token age em nome da empresa, dentro do plano
• Rotacione se houver vazamento (gere um novo token na mesma tela)
• Prefira variáveis de ambiente no seu backend (WHATSWAVE_API_TOKEN), nunca hardcode no front público

Próximos passos

• API REST e GraphQL — visão geral das duas superfícies
• Como listar boards e colunas do CRM via API
• Como obter os contatos de uma coluna do CRM via API