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".
-
Vá para "Tokens de Acesso" em "Configurações".
-
Vá para "Gerar Token de Acesso".
- Escolha a data e hora de expiração. Se não selecionar nenhum horário, o token será de longa duração.
- Selecione o escopo e permissões que você precisa no token de acesso.
- Selecione o comprimento do token que você gostaria de obter. Em seguida, clique em "Gerar".
- O 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 |
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.
Para revogar um token de acesso, selecione "Mais" e depois "Revogar".
