Token da Empresa em Configurações
O Token da Empresa é uma credencial única, válida para a empresa inteira, que funciona nas mesmas APIs que já aceitam o token da Conexão. Com ele você guarda um token só no seu sistema, em vez de um para cada Conexão — e, em troca, passa a dizer em cada chamada por qual Conexão ela deve sair.
Ideal para:
Integração que fala por várias Conexões: um token só no seu código, em vez de um por Conexão.
Trocar a Conexão sem mexer na credencial: a Conexão vira um dado da chamada, não a chave de acesso.
Resumo Prático
Acesse o menu Configurações → Token da Empresa.
Clique em GERAR UM NOVO e depois em COPIAR.
Use o token no cabeçalho Authorization: Bearer <token> e informe a Conexão em toda chamada.
Como gerar, copiar e revogar
Acesse o menu Configurações → Token da Empresa
GERAR UM NOVO: cria o token da empresa. O token anterior para de funcionar na hora.
COPIAR: copia o token exibido no campo.
REVOGAR: invalida o token atual, que para de funcionar na hora. Revogar não mexe em nenhuma Conexão — os tokens de Conexão seguem funcionando como antes.
Este token vale por toda a empresa. Quem o tiver pode falar por qualquer Conexão dela. Guarde-o como guarda uma senha, e revogue na hora se desconfiar que vazou.
Existe um token de cada vez. Tanto gerar quanto revogar derrubam o token anterior imediatamente, e.
Como informar a Conexão na chamada
Com o Token da Empresa, informar a Conexão é obrigatório em toda chamada.
Informe whatsappId, connectionId ou whatsappName — na query string (ex.: ?connectionId=67) ou no corpo da requisição (ex.: "connectionId": "67").
Para indicar a Conexão pelo nome em vez do id, use whatsappName. Na query string, o espaço do nome precisa ir escrito como %20 — por exemplo, ?whatsappName=Ag%20Oficial.
Em envio com arquivo, use a query string.
Sem esse dado a chamada é recusada com 400, e a resposta diz o que está faltando.
A aba traz a lista Conexões desta empresa, com o ID, o Nome e a Situação de cada uma. São esses os valores a usar na chamada.
Token da Empresa e Token da Conexão convivem
Nada muda para quem usa o token da Conexão.
Dúvidas Comuns
Gerar um novo token invalida o anterior? Sim. Gerar e revogar derrubam o token antigo na hora — existe um de cada vez.
Revogar o Token da Empresa derruba as minhas integrações? Só as que usam esse token. Nenhuma Conexão é alterada, e o que usa token de Conexão segue funcionando.
Posso usar os dois ao mesmo tempo? Pode. São credenciais independentes, e numa chamada em que as duas apareçam vale a Conexão.
Onde eu acho o ID da Conexão? Na própria aba, na lista Conexões desta empresa.
Erros Comuns
A chamada volta com erro 400 pedindo a Conexão: você autenticou com o Token da Empresa e não informou whatsappId, connectionId ou whatsappName. Acrescente o parâmetro na query string ou no corpo da requisição.
As integrações pararam logo depois de você mexer nesta aba: gerar um novo token ou revogar derruba o anterior imediatamente. Cole o token novo no seu sistema para elas voltarem.