# Criar um aplicativo ou conectar webhooks

Crie um aplicativo OAuth que outros usuários do Drime conectam às contas deles, receba webhooks e seja avisado dos eventos do Drime Sign no seu servidor.

Atualizado em: 2026-10-19  
Fonte: https://drime.cloud/pt-br/support/integrations-and-api/build-an-integration

Para usar a API do Drime na sua própria conta, basta um token pessoal: consulte [Criar um token de API](https://drime.cloud/pt-br/support/integrations-and-api/api-tokens). Para criar um aplicativo que outros usuários do Drime conectam às contas deles, crie um aplicativo OAuth: os usuários o aprovam no Drime, e ele nunca vê a senha deles.

## Criar um aplicativo OAuth

Qualquer usuário conectado pode criar aplicativos no portal do desenvolvedor, em **Meus aplicativos** e depois **Criar aplicativo**.

![O formulário Criar aplicativo do portal do desenvolvedor, com os três tipos de aplicativo](https://drime.cloud/media/01M5AT6DMNDAVYH6SJW5CDQYFB/8439d64a4ecd-web-developers-create-application.png)

Primeiro, você escolhe o que está criando:

| Opção | Para |
| --- | --- |
| **Um site ou um servidor** | Você recebe uma chave secreta para guardar no seu servidor. |
| **Um app de desktop ou celular** | Instalado nos dispositivos dos seus usuários, por isso sem chave secreta. |
| **Um script, só para mim** | Uma pequena ferramenta que você mesmo executa. |

Depois, você escolhe do que o aplicativo precisa: **Uma pasta própria** (ele só vê uma pasta, criada no Drive) ou **Todo o Drive**.

Bom saber:

- Você pode criar até 25 aplicativos.
- Um novo aplicativo funciona para até 25 usuários. Para abri-lo para mais pessoas, use **Abrir para todos** e depois **Enviar para análise**: o Drime responde em até 24 horas.
- Os tokens de acesso duram 1 hora, e os tokens de atualização, 90 dias.
- Aplicativos de terceiros nunca podem acessar um Vault.

Os aplicativos do tipo **Um site ou um servidor** também podem receber webhooks quando arquivos são criados ou excluídos em uma conta conectada. Cada notificação é assinada no cabeçalho `X-Drime-Signature`.

## Webhooks do Drime Sign

Em **Configurações** \> **Desenvolvedores** \> **Webhooks** (**Notificações HTTP dos eventos do Drime Sign.**), clique em **Adicionar um webhook** para que seu servidor seja notificado quando, por exemplo:

- um documento é enviado, concluído ou recusado;
- um signatário visualiza, assina ou recusa;
- um modelo é criado.

![A seção Webhooks das configurações de Desenvolvedores, com Adicionar um webhook](https://drime.cloud/media/01M5AKQ8TWF4KP6TWB0GPD9RK7/f4d9572805b0-web-sign-webhooks.png)

Cada notificação é assinada com um segredo (`X-Drime-Signature`, HMAC SHA-256). Uma notificação que falha é reenviada até 10 vezes ao longo de cerca de 34 horas. Você pode usar **Enviar um teste** e **Trocar o segredo**, e conferir as **Entregas**.

## Incorporar um formulário de assinatura no seu site

Em **Configurações** \> **Desenvolvedores** \> **Incorporação**, você pode permitir que os visitantes assinem documentos sem sair do seu site, com o widget `<drime-sign-form>`. Adicione seus domínios em **Domínios permitidos**: sem nenhum domínio, a incorporação fica desativada.

## Próximos passos

- [Criar um token de API](https://drime.cloud/pt-br/support/integrations-and-api/api-tokens)
- [Rclone, Drime CLI e WebDAV](https://drime.cloud/pt-br/support/integrations-and-api/rclone-cli-and-webdav)