Aprenda a gerar e utilizar o token de integração da API.
Autenticação com Bearer Token
A API do Chatbot V4 SINCorp utiliza um token permanente enviado no cabeçalho HTTP Authorization.
O formato correto é:
Authorization: Bearer SEU_TOKEN_DE_INTEGRACAONo campo Credentials desta documentação, informe somente o token, sem escrever
Bearer. O ReadMe adicionará esse prefixo automaticamente. Em integrações feitas diretamente por código, envie o cabeçalho completo:Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO.
Exemplo de requisição
curl --request GET \
--url https://api.chatbotv4.sincorp.com.br/chat/v1/channel \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO'Como obter o token
O token permanente da conta pode ser gerado na seção de integrações da plataforma.
Para endpoints específicos de Gestão de Contas ou Parceiros, utilize o Token de Parceiro, disponível em:
Admin > Personalizar > IntegraçãoCuidados de segurança
- Não publique o token em repositórios ou capturas de tela;
- Não envie o token diretamente na URL;
- Armazene-o como variável de ambiente ou segredo;
- Gere um novo token caso suspeite de exposição;
- Utilize apenas os acessos necessários para cada integração.
Problemas comuns
| Situação | Verificação recomendada |
|---|---|
| Token recusado | Confira se o prefixo Bearer foi informado |
| Acesso não autorizado | Verifique se o token pertence à conta correta |
| Endpoint de parceiro recusado | Utilize o Token de Parceiro |
| Erro ao copiar | Envie o token sem aspas ou colchetes |
Nunca envie seu token ao suporte técnico. Caso seja necessário analisar uma requisição, remova o token antes de compartilhar o exemplo.