Resumo

Para conectar sua aplicação ou integração ao Wati, você precisa de um token de API e da URL de endpoint da API correta. Este guia explica como gerar um novo token de API, configurar sua expiração e permissões, e encontrar a URL de endpoint correta para as APIs v1, v2 e v3.

Instruções

Gerar um token de API no Wati

Siga estas etapas para gerar um novo token de API:

  • Faça login na sua conta Wati.

  • Vá para Connectors (Conectores) > API Tokens (Tokens de API).

  • Clique em Generate new token (Gerar novo token).

  • Insira um nome para o seu token, se solicitado.

  • Defina a duração de expiração do token de acordo com suas necessidades.

  • Em Scope (Escopo), selecione as permissões necessárias para sua integração. Selecione Select all (Selecionar tudo) se sua integração precisar de todas as permissões disponíveis.

  • Clique na opção de gerar e copie o token.

Importante

  • Seu token de API é exibido apenas uma vez quando você o gera. Copie-o e armazene-o de forma segura antes de fechar a janela. Se você perder o token, deverá gerar um novo e atualizar sua integração.

  • O antigo Bearer Token, disponível anteriormente na página API Docs (Documentação da API), expirava quando a senha do usuário associado era alterada. Esse comportamento se aplica apenas aos tokens legados e não se aplica aos tokens de API recém-gerados. Novos tokens de API permanecem válidos até a data de expiração configurada ou até serem rotacionados manualmente.

Encontre seu Endpoint de API

Você pode encontrar seu Endpoint de API na mesma página dos tokens.

O Wati usa a seguinte URL base (host) para solicitações de API:

https://live-mt-server.wati.io

O formato da URL do endpoint depende da versão da API que você está usando.

Para APIs v1 e v2

Inclua seu ID de tenant do Wati imediatamente após a URL base, seguido pelo caminho da API.

https://live-mt-server.wati.io/{tenantId}/api/v1/...

Substitua {tenantId} pelo seu ID de tenant do Wati.

Para APIs v3

Não inclua seu ID de tenant na URL. Use o caminho da API v3 diretamente após a URL base.

https://live-mt-server.wati.io/api/ext/v3/...

Importante: Não adicione /{tenantId}/ às URLs de endpoint da API v3. Isso resultará em uma URL de endpoint incorreta.

Observações importantes sobre tokens de API

  • Expiração do token: Seu token de API permanece válido até a data de expiração configurada ou até ser rotacionado manualmente.

  • Segurança do token: Mantenha seu token de API confidencial. Não o compartilhe publicamente nem o exponha em código no lado do cliente.

  • Permissões do token: Selecione as permissões que sua integração precisa ao gerar o token.

  • Substituição de token: Se você gerar um token de substituição, atualize sua integração para usar o novo token.

  • Legacy Bearer Token: O antigo Bearer Token disponível anteriormente em API Docs não está mais disponível. Você deve gerar um novo token de API em Connectors > API Tokens.

O Wati introduziu o novo processo de geração de tokens para melhorar a segurança. Ele permite configurar a duração de expiração e as permissões do token, o que não era possível com o antigo Bearer Token.

Para obter mais informações sobre endpoints e operações de API disponíveis, consulte a documentação da API do Wati.

Perguntas Frequentes (FAQs)

Geração e autenticação de token de API

1. Onde posso gerar um token de API no Wati?

Você pode gerar um token de API fazendo login na sua conta Wati e navegando até Connectors > API Tokens. Clique em Generate new token, configure a duração de expiração e as permissões do token, e gere o token.

2. O antigo Bearer Token em API Docs ainda está disponível?

Não. O antigo Bearer Token disponível anteriormente em API Docs não está mais disponível. Você deve gerar um novo token de API em Connectors > API Tokens para autenticar suas solicitações de API.

3. Por que o Wati exige a geração de um novo token de API?

O Wati introduziu o novo processo de geração de tokens de API para melhorar a segurança. Ele permite configurar a duração de expiração do token e selecionar as permissões concedidas a ele.

Gerenciamento de token de API

4. Posso recuperar um token de API gerado anteriormente ou configurar sua duração de expiração?

Não. Você não pode recuperar um token de API gerado anteriormente, pois o Wati exibe o token apenas uma vez quando ele é criado.

Você pode configurar a duração de expiração ao gerar um novo token de API. O token permanece válido até expirar ou ser rotacionado manualmente.

Se você perder seu token de API, gere um novo em Connectors > API Tokens e atualize sua integração para usá-lo.

URLs de endpoint da API

5. Quando devo incluir meu ID de tenant na URL de endpoint da API do Wati?

Inclua seu ID de tenant imediatamente após a URL base ao usar endpoints das APIs v1 e v2 do Wati.

Não inclua seu ID de tenant nas URLs de endpoint da API v3, que usam o caminho /api/ext/v3/.

Did this answer your question?