Chaves de API e Webhooks
Se a sua empresa integra a Assin com outros sistemas (ERP, CRM, site), use chaves de API para enviar e consultar envelopes e webhooks para receber avisos automáticos quando algo acontece. Tudo fica em Integrações no menu lateral, com as opções API Keys e Webhook.
Só para empresa (PJ): Esta função não está disponível na conta de pessoa física. Veja a diferença em Usando a Assin como pessoa física.
O menu Integrações aparece para empresas com o acesso à API liberado no plano, e a tela de chaves é restrita a gestores da empresa (veja Colaboradores e permissões). Se você não o vê, fale com o Suporte ou com o seu gestor.
API Keys
1. Em Integrações > API Keys, a lista mostra o Nome, a Public Key, o Status (Ativa ou Inativa), a data em Criado em e Atualizado em e as Ações. Chaves inativas criadas há mais de 12 meses ganham o aviso “Chave antiga: considere regenerar”.

2. Para criar, clique em “Nova API Key”. Na janela Nova API Key, dê um nome que identifique a integração (por exemplo, “Integração ERP”) e clique em “Avançar”.

3. A Assin mostra a Public Key e a Secret Key, com botões para copiar. A Secret Key só é exibida uma vez: copie e guarde as duas em local seguro antes de clicar em “Fechar”. Quem tem as chaves acessa a conta da sua empresa.
4. Em Ações você pode:
- Ativar chave / Desativar chave: liga ou desliga o uso da chave sem excluí-la.
- Regenerar chave: gera novas credenciais no lugar das atuais, depois de uma confirmação. A ação não pode ser desfeita e as integrações que usam a chave antiga precisam ser atualizadas.
- Deletar chave: remove a chave definitivamente. Para confirmar, digite o nome da chave na janela Remover API Key.
Boas práticas: crie uma chave por integração, nunca compartilhe a chave por e-mail ou chat e desative as que não usa mais. As requisições são feitas pela API pública da Assin (documentação disponível para a sua equipe de desenvolvimento). Quando uma nova chave é criada, a Assin também envia um e-mail de aviso (veja E-mails que a Assin envia).
Webhooks
Um webhook é um endereço (URL) do seu sistema que recebe um aviso da Assin quando um evento acontece, por exemplo, quando um envelope é finalizado.
5. Em Integrações > Webhook (tela Destinos de evento), a lista mostra a URL do endpoint, a Descrição e as Ações (editar e excluir).

6. Clique em “Novo endpoint”. Na janela Criar novo endpoint, informe a URL do endpoint e uma descrição (até 200 caracteres) e clique em “Avançar”. A URL precisa ser pública e usar HTTPS: não pode ser localhost, um endereço da rede interna nem conter usuário e senha.

7. Use o lápis (Editar endpoint) para alterar e a lixeira (Deletar endpoint) para excluir (a plataforma pergunta “Deseja deletar esse endpoint?”). Ao abrir um endpoint você também vê o histórico de entregas, com horário e endereço IP.
Quem integra pela API pública pode ainda escolher os eventos de cada webhook (envelope finalizado, envelope cancelado, envelope expirado e assinatura de cada signatário), definir cabeçalhos personalizados (por exemplo, para autenticação) e reprocessar entregas que falharam.
Pontos de atenção:
- O seu servidor deve responder com sucesso (código 2xx) em até 10 segundos e tratar o mesmo evento com segurança caso ele chegue mais de uma vez (idempotência).
- Se o seu sistema estiver fora do ar, a Assin registra a falha no log do endpoint, mas não reenvia automaticamente. Para reenviar as entregas que falharam, use o reprocessamento da API pública.
Para mais informações acesse nosso site https://assin.com.br/
Viu como é simples Assin?
Assin Assinatura Digital
Este artigo foi útil?
Obrigado pelo feedback!
Não encontrou o que procurava?
Nosso time responde de segunda a sexta, em horário comercial. Conte com a gente.