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.

1. Clique novamente em Gerar token para concluir.

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

Importante: Copie e armazene o token em um local seguro. Após fechar a janela, não será possível visualizá-lo novamente.

---

Webhooks

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

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.

Para criar um webhook, siga os passos abaixo:

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

1. 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.

1. 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:

• Conexão:

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

A partir desse momento, sempre que o evento selecionado ocorrer, as informações serão enviadas automaticamente para a URL cadastrada.

---

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.

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.

1. Desative a chave do Status, deixando-a desativada.

1. Clique em Salvar.

1. 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.