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.

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.

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.