# 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FfchSxGODkxMru9lyXhm4%2Fimage.png?alt=media&#x26;token=5601dc3e-2f23-4c04-9d9c-dce885d452ad" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FALgp6JuTxKznlsRI5u7k%2Fimage.png?alt=media&#x26;token=85fad9e1-6554-4f63-97e3-2aef9164ffd7" 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FoRb3GV0rBFpRBPYfldiM%2Fimage.png?alt=media&#x26;token=abab70dc-8963-444e-a851-6e112b32f40f" 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F3yd4y3ev7lwoDwKh31BX%2Fimage.png?alt=media&#x26;token=606d118a-da31-4763-b866-ed2d46745b90" 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F270kPERn9Zt5gbFbV4yJ%2Fimage.png?alt=media&#x26;token=3fb085b5-6af0-48e8-bc03-8a7b405edfea" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FJyG9FmXzm46C57xcJSjg%2Fimage.png?alt=media&#x26;token=f44995fd-bd16-4d4e-80bf-a48edc69823a" alt="" width="351"><figcaption></figcaption></figure>

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

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FfBmrfyEtMHCXbBeNC9EK%2Fimage.png?alt=media&#x26;token=b9664a56-6ec6-414f-b438-57e4d17b3116" 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FwiesNrscTxKSa6ewZjho%2Fimage.png?alt=media&#x26;token=ff08cad8-f869-4a31-8149-70dc9b64b18e" 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F0depsylGAr7mMEhEVHpF%2Fimage.png?alt=media&#x26;token=cccd0659-1964-4acc-a295-4b303b000256" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F6VMe75P5vHTQWrbndU71%2Fimage.png?alt=media&#x26;token=2455a9c7-0214-4592-aec5-5bdb196209ef" alt="" width="534"><figcaption></figcaption></figure>

3. Clique em **Salvar**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FfZjdTA2Ort3QtYAGFRPr%2Fimage.png?alt=media&#x26;token=6f5428e0-1a09-467f-bea3-34625ff948c5" 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="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FYPAFhvrxW6DaiQZH63sp%2Fimage.png?alt=media&#x26;token=4dd798da-55f5-4d06-a6c5-a4fcb651d248" alt=""><figcaption></figcaption></figure>
