# Token e Webhook

### Token

O **Token** é um mecanismo de autorização utilizado para realizar ações dentro da plataforma por meio de **integrações ou métodos externos**, como APIs.

Para criar um Token, siga os passos abaixo:

1. No **Menu do Usuário**, selecione **Conta** > **API** > **Tokens de acesso pessoal**.
2. Na tela exibida, clique em **Gerar token**.
3. Informe um **nome** para identificar o token.
4. Defina um **prazo de expiração**. O prazo pode ser:

* 30 dias;
* 90 dias;
* 180 dias;
* 1 ano;
* Não expirar.

5. Clique novamente em **Gerar token** para concluir.

<figure><img src="/files/6Lg5ww2uTrUTvE33yefk" alt=""><figcaption></figcaption></figure>

Após a geração, uma nova janela será aberta exibindo o token criado.

<figure><img src="/files/JSQEatvrcK7QyUedQsyn" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Importante:** Copie e armazene o token em um local seguro. Após fechar a janela, **não será possível visualizá-lo novamente**.
{% endhint %}

***

### Webhooks

Os **Webhooks** permitem integrar a Digisac com sistemas externos, enviando automaticamente informações sempre que determinados eventos ocorrerem na plataforma.

{% hint style="success" %}
**Novidade:** agora é possível utilizar **webhooks de criação e alteração no Funil de Vendas**, permitindo integrar essas informações com sistemas externos e ter maior controle sobre os dados das oportunidades. Além disso, também é possível criar **webhooks para a funcionalidade Kanban**, possibilitando **enviar ou receber informações relacionadas aos quadros e chamados**.
{% endhint %}

Para criar um webhook, siga os passos abaixo:

1. No **Menu do Usuário**, selecione **Conta** > **API** > **Webhook** e clique em **Criar Webhook**.

<figure><img src="/files/YHUpJYn1mwOTclbgl76w" alt=""><figcaption></figcaption></figure>

2. **Ative a chave** de status caso deseje que o webhook seja criado já ativo e, em seguida, preencha as seguintes informações:

* **Nome:** identificação do webhook criado.
* **URL:** endereço do sistema externo que receberá os eventos enviados pelo webhook.
* **Tipo:** define o escopo das informações que serão enviadas pela plataforma. As opções são:
  * **Geral:** permite selecionar quais eventos da plataforma serão enviados.
  * **Conexão:** envia apenas os eventos relacionados à conexão selecionada.

<figure><img src="/files/zWRpqIjxcWVcAzOt2fzs" alt="" width="375"><figcaption></figcaption></figure>

3. Após escolher o tipo, novos campos de **Eventos** serão exibidos. Selecione as opções de acordo com as definições do webhook que deseja criar. Basta clicar na caixa de seleção dos eventos desejados.

* **Geral:**

<figure><img src="/files/wRwJI834PO6ocYTRpLGj" alt=""><figcaption></figcaption></figure>

* **Conexão:**&#x20;

<figure><img src="/files/zpLggeAL1ETwfQe4Y6gH" alt="" width="351"><figcaption></figcaption></figure>

4. Por fim, clique em **Salvar** para concluir a criação do webhook.

<figure><img src="/files/vj4rUFbfjMCOcIybVzhw" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
&#x20;A partir desse momento, sempre que o **evento selecionado ocorrer**, **as informações serão enviadas** automaticamente **para a URL** cadastrada.
{% endhint %}

***

### Gerenciando Webhooks

Para **visualizar, editar ou excluir** um webhook já criado, clique nos **três pontinhos** ao lado do webhook desejado e selecione a ação correspondente.

<figure><img src="/files/rkS8PY94vaoFcpQiOJ20" alt=""><figcaption></figcaption></figure>

#### Excluindo um webhook

Antes de excluir um webhook, é necessário **desativá-lo**.

Para isso:

1. Clique nos **três pontinhos** do webhook desejado e selecione **Editar**.

<figure><img src="/files/opwaxWiJsucOa0ViWoSH" alt=""><figcaption></figcaption></figure>

2. Desative a chave do **Status**, deixando-a desativada.

<figure><img src="/files/dwVywvjHG2kz6Bh8ZRfh" alt="" width="534"><figcaption></figcaption></figure>

3. Clique em **Salvar**.

<figure><img src="/files/FNlKj3n6A7o9fV0yiD5n" alt="" width="563"><figcaption></figcaption></figure>

4. Após desativar o webhook, selecione a opção **Excluir** nos **três pontinhos** e confirme a ação no modal exibido, clicando novamente em **Excluir**.

<figure><img src="/files/Eo2k9LUE9zrLiK0vyfEB" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://digisac.gitbook.io/manual-digisac-2-0/menu-do-usuario/conta/token-e-webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.