Como gerar e gerenciar tokens de acesso no WOZTELL

Token de acesso

Um token de acesso é uma string opaca que identifica um usuário ou os privilégios de um usuário e pode ser usado por aplicativos para fazer chamadas API para o WOZTELL.

Permissões de Escopo

O token inclui informações sobre quando o token expirará e qual usuário gerou o token. Existem diferentes escopos e permissões de tokens de acesso para suportar diferentes casos de uso:

Tipo de Token de Acesso Descrição
bot:admin Concede acesso a todas as APIs de Bot
bot:sendResponses Concede permissões para enviar respostas em nome do bot
bot:redirectMemberToNode Concede permissões para redirecionar o membro para o nó em nome do bot
api:admin Concede acesso a todas as APIs
integration:admin Concede acesso a todas as APIs de Integração
integration:write Concede permissões para criar e atualizar Integração
integration:delete Concede permissões para excluir Integração
file:admin Concede acesso a todas as APIs de Arquivos
file:waGet Concede permissões para obter URL de arquivo por ID de mídia do WhatsApp
member:admin Concede acesso a todas as APIs de Membro
member:read Concede permissões para ler a lista de Membros por externalId ou memberId
member:write Concede permissões para criar e atualizar Membro

Geração de Token de Acesso

Tokens de acesso são gerados por meio do seguinte método. Vá para "Configurações" -> "Tokens de Acesso".

  1. Vá para "Tokens de Acesso" em "Configurações".

  2. Vá para "Gerar Token de Acesso".

Access Token in Settings
Token de Acesso nas Configurações
  1. Escolha a data e hora de expiração. Se não selecionar nenhum horário, o token será de longa duração.
Access Token with Expiry Date
Token de Acesso com Data de Expiração
Skip the Expiration Time if you want the Access Token to be long-lived.
Pule o Tempo de Expiração se quiser que o Token de Acesso seja de longa duração.
  1. Selecione o escopo e permissões que você precisa no token de acesso.
Select Scopes
Selecionar Escopos
  1. Selecione o comprimento do token que você gostaria de obter. Em seguida, clique em "Gerar".
Generate Access Token
Gerar Token de Acesso
  1. Token de Acesso no comprimento selecionado será gerado.

Gestão

Sob Tokens de Acesso Ativos, os tokens de longa e curta duração podem ser visualizados em abas separadas.

Item Descrição
Token de Acesso O token de acesso gerado, você pode clicar para copiar o token
Criador O usuário que gerou o token de acesso
Escopos Os escopos e permissões concedidos
Usando para A extensão associada ao token de acesso. "Plataforma Woztell" será exibida se o token de acesso for gerado por um usuário em vez de uma extensão.
Expirado em O horário de expiração do token de acesso; "Nunca" significa que o token é de longa duração
Active Access Token
Token de Acesso Ativo

Se um token de acesso for gerado por uma extensão, a extensão associada será exibida sob "Usando Para". Os tokens gerados por extensões não podem ser excluídos manualmente por um usuário, a menos que a extensão associada seja desinstalada.

Locked Access Token
Token de Acesso Bloqueado

Para revogar um token de acesso, selecione "Mais" e depois "Revogar".

Revoke Access Token
Revogar Token de Acesso