Resumo
Um token de API permite que sistemas externos, como plataformas de Customer Relationship Management (CRM) ou aplicativos personalizados, se conectem com segurança ao Wati e acessem suas APIs. Este guia explica como gerar um token de API no Wati, escolher as permissões corretas e armazenar o token com segurança para uso futuro.
Instruções
Siga os passos abaixo para gerar um novo token de API em sua conta Wati.
Passo 1: Faça login na sua conta Wati
Faça login na sua conta Wati.
Passo 2: Vá para a página de configurações da API
No menu de navegação, vá para Connector → API → Create API Token.
Isso abrirá a página API Tokens, onde você pode gerenciar seus tokens.
Passo 3: Gere um novo token de API
Na página API Tokens, clique em Generate new token.
Insira um nome de token para identificar o token.
Passo 4: Selecione as permissões necessárias (scopes)
Escolha as permissões que sua integração precisa. Essas permissões são chamadas de scopes e definem o que o token tem permissão para acessar.
Exemplos de scopes comumente usados incluem:
contacts:read— Permite a leitura de dados de contatocontacts:write— Permite criar ou atualizar contatosmessagetemplate:read— Permite ler informações do modelo de mensagem
Selecione apenas os scopes necessários para sua integração para melhorar a segurança.
Passo 5: Defina uma data de validade (opcional)
Você pode definir uma data de validade para o token. Isso ajuda a reduzir os riscos de segurança, limitando o tempo em que o token permanece ativo.
Para uma melhor segurança, é recomendável rotacionar os tokens de API a cada 6 meses.
Passo 6: Copie e armazene o token com segurança
Após a geração do token:
Copie o token imediatamente.
Armazene-o com segurança em seu gerenciador de senhas ou ambiente seguro.
Importante: O token é exibido apenas uma vez no momento da geração. Se você o perder, precisará gerar um novo token.
Notas:
A opção Create New Token remove as dependências no nível do usuário, o que significa que o token não depende de uma conta de usuário específica.
O token permanecerá ativo até:
Atingir a data de validade, ou
Ser atualizado ou revogado manualmente.
Manter seus tokens de API seguros ajuda a proteger suas integrações e impede o acesso não autorizado à sua conta Wati.
Perguntas Frequentes (FAQs)
Tokens de API em Wati
1. O que é um token de API no Wati?
Um token de API permite que sistemas externos, como plataformas de Customer Relationship Management (CRM) ou aplicativos personalizados, se conectem com segurança ao Wati e acessem suas APIs.
2. Como gero um novo token de API no Wati?
Para gerar um novo token de API no Wati, faça login na sua conta Wati e vá para Connector → API → Create API Token. Na página API Tokens, clique em Generate new token, insira um nome de token, selecione as permissões necessárias (scopes), defina opcionalmente uma data de validade e gere o token.
3. Quais permissões (scopes) podem ser selecionadas ao gerar um token de API?
As permissões nos tokens da API Wati são chamadas de scopes e definem o que o token pode acessar. Exemplos de scopes incluem contacts:read para leitura de dados de contato, contacts:write para criar ou atualizar contatos e messagetemplate:read para leitura de informações do modelo de mensagem.
4. Uma data de validade pode ser definida para um token de API no Wati?
Sim. Você pode, opcionalmente, definir uma data de validade ao gerar um token de API no Wati. Definir uma data de validade limita o tempo em que o token permanece ativo e ajuda a reduzir os riscos de segurança.
5. Com que frequência os tokens de API devem ser rotacionados por segurança?
Para uma melhor segurança, é recomendável rotacionar os tokens de API a cada 6 meses.
6. Por que o token de API gerado deve ser copiado e armazenado imediatamente?
O token de API é exibido apenas uma vez no momento da geração. Se o token não for copiado e armazenado com segurança quando for gerado, você precisará criar um novo token.
Comportamento e Validade do Token de API
7. A opção Create New Token depende de uma conta de usuário específica?
Não. A opção Create New Token remove as dependências no nível do usuário, o que significa que o token de API não depende de uma conta de usuário específica.
8. Por quanto tempo um token de API permanece ativo no Wati?
Um token de API no Wati permanece ativo até atingir sua data de validade ou até ser atualizado ou revogado manualmente.