Claves de API y Webhooks

Si tu empresa integra Assin con otros sistemas (ERP, CRM, sitio web), usa claves de API para enviar y consultar sobres y webhooks para recibir avisos automáticos cuando algo ocurre. Todo está en Integraciones en el menú lateral, con las opciones API Keys y Webhook.

Solo para empresa (PJ): Esta función no está disponible en la cuenta de persona física. Mira la diferencia en Usando Assin como persona física.

Este menú aparece para empresas con acceso a la API habilitado en el plan. Si no lo ves, habla con Soporte o con tu gestor.

API Keys

1. En Integraciones > API Keys, la lista muestra el Nombre, la Public Key, el Estado (Activa o Inactiva), la fecha de creación y de actualización y las Acciones.

2. Para crear una, haz clic en “Nueva API Key”, dale un nombre que identifique la integración (por ejemplo, “Integración CRM”) y haz clic en “Avanzar”. Copia la clave generada y guárdala en un lugar seguro: da acceso a la cuenta de tu empresa.

3. En Acciones puedes:

• Activar clave / Desactivar clave: enciende o apaga el uso de la clave sin eliminarla.
• Regenerar clave: genera una nueva clave en lugar de la actual. La acción no se puede deshacer y las integraciones que usan la clave antigua deben actualizarse.
• Eliminar clave: quita la clave definitivamente.

Buenas prácticas: crea una clave por integración, nunca compartas la clave por correo o chat y desactiva las que ya no uses. Las solicitudes se hacen mediante la API pública de Assin (documentación disponible para tu equipo de desarrollo).

Webhooks

Un webhook es una dirección (URL) de tu sistema que recibe un aviso de Assin cuando ocurre un evento, por ejemplo, cuando un sobre se finaliza.

4. En Integraciones > Webhook (pantalla Destinos de evento), la lista muestra la URL del endpoint, la Descripción y las Acciones (editar y eliminar).

5. Haz clic en “Nuevo endpoint”, informa la URL y una descripción (hasta 200 caracteres) y haz clic en “Avanzar”. La URL debe ser pública y usar HTTPS: no puede ser localhost ni una IP de la red interna.

6. Usa el lápiz para editar y la papelera para eliminar un endpoint (la plataforma pregunta “¿Deseas eliminar este endpoint?”). Al abrir un endpoint también ves el historial de entregas, con hora y dirección IP.

Puntos de atención:

• Tu servidor debe responder con éxito (código 2xx) y tratar el mismo evento con seguridad por si llega más de una vez (idempotencia).
• Si tu sistema está fuera de servicio, Assin registra el fallo en el log del endpoint, pero no reenvía automáticamente.

Para más información visita nuestro sitio https://assin.com.br/

¿Viste qué simple es Assin?

Assin Firma Digital