# Usar o acesso à API

> Crie tokens de acesso pessoal para scripts e clientes MCP e envie eventos do seu Livespace aos seus próprios sistemas com webhooks.

Em Ajustes › **Acesso à API**, você cria tokens de acesso pessoal para que um script ou cliente MCP possa usar Dvina em seu nome. Os administradores também adicionam webhooks nessa seção para enviar eventos do Livespace aos seus próprios sistemas.

O acesso à API está incluído no plano Enterprise. Todos os membros podem criar seus próprios tokens; apenas proprietários e administradores veem **Webhooks**.

## Criar um token

1. Abra Ajustes e escolha **Acesso à API**.
2. Em **Tokens de acesso pessoal**, escolha **Criar token**.
3. Digite um **Nome** para identificar depois o que usa esse token.
4. Escolha o **Acesso**: **Somente leitura** ou **Leitura e gravação**.
5. Escolha quando ele **Expira**: **Em 30 dias**, **Em 90 dias**, **Em 365 dias** ou **Nunca expira**.
6. Escolha **Criar token**.
7. Em **Copie seu token**, copie o token e guarde-o em um local seguro. Ele só é exibido nesse momento.

Um token atua em seu nome, no Livespace em que você o criou, com a função que você tem nele atualmente. Um token de **Somente leitura** pode ler, mas não pode adicionar nem alterar nada.

Para usar um token com um cliente MCP, consulte [Conectar com uma chave de API em vez de OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Consultar, renovar ou revogar um token

Seus tokens aparecem em **Tokens de acesso pessoal**, com o acesso de cada um. Escolha um token para ver os campos **Começa com**, **Acesso**, **Último uso** e **Expira**.

- **Para substituir um token**, escolha **Renovar…** e depois **Renovar** para confirmar. Um novo token substitui o anterior, que deixa de funcionar imediatamente. Copie o novo token em **Copie seu token**.
- **Para desativar um token**, escolha **Revogar…** e depois **Revogar** para confirmar. Tudo o que usa esse token deixa de funcionar imediatamente.

A criação, a renovação e a revogação de um token são registradas no [log de auditoria](/docs/teams/audit-log).

## Adicionar um webhook

Um webhook envia os eventos do Livespace, os mesmos registros do [log de auditoria](/docs/teams/audit-log), para um endereço que você escolhe.

1. Em Ajustes › **Acesso à API**, na seção **Webhooks**, escolha **Adicionar webhook**.
2. Digite um **Nome** e a **URL**. Use uma URL HTTPS pública.
3. Em **Eventos**, deixe o campo vazio para receber todos os eventos ou liste ações e áreas, como `member.added` ou `sharing.*`.
4. Escolha **Adicionar**.
5. Em **Copie o segredo de assinatura**, copie o segredo. Ele só é exibido nesse momento.

Se Dvina exibir **Não é possível acessar este endereço a partir de Dvina**, use uma URL HTTPS pública.

### Verificar a assinatura de cada requisição

Dvina envia eventos em lotes, em formato JSON, e assina cada requisição. Use o segredo de assinatura para verificar se uma requisição veio de Dvina:

- Cada requisição tem um cabeçalho `X-Dvina-Signature` no formato `t=<timestamp>,v1=<signature>`.
- A assinatura é um HMAC-SHA256, em hexadecimal, do timestamp, seguido de um ponto e do corpo da requisição, gerado com seu segredo de assinatura.
- Calcule a assinatura e compare. Rejeite uma requisição se a assinatura não corresponder ou se o timestamp for antigo demais.

## Consulte ou altere um webhook

Seus webhooks aparecem em **Webhooks** com o status: **Ativo**, **Pausado** ou **Com falha**. Selecione um para ver os detalhes.

- **Para alterá-lo**, edite o **Nome**, a **URL** ou os **Eventos** e selecione **Salvar**.
- **Para pausá-lo**, desative **Enviar eventos**. Ative essa opção novamente para retomar o envio.
- **Para acompanhar o funcionamento**, confira o **Status** e quantos eventos foram **Enviados**. Um webhook com falha mostra o **Último erro**. A Dvina continua tentando e registra a falha no log de auditoria.
- **Para alterar o segredo**, selecione **Novo segredo de assinatura…** e confirme. As solicitações passam a ser assinadas com o novo segredo imediatamente, então atualize o receptor assim que fizer a alteração.
- **Para removê-lo**, selecione **Excluir…** e depois **Excluir** para confirmar. Nada mais será enviado a ele.

## Conteúdo relacionado

- [Use a Dvina em outros apps com o MCP](/docs/dvina-mcp/overview)
- [Use o log de auditoria](/docs/teams/audit-log)
- [Visão geral das equipes](/docs/teams/overview)