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.
El menú Integraciones aparece para empresas con acceso a la API habilitado en el plan, y la pantalla de claves es exclusiva de los gestores de la empresa (consulta Colaboradores y permisos). 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), las fechas de Creado en y Actualizado en y las Acciones. Las claves inactivas creadas hace más de 12 meses muestran el aviso “Clave antigua: considera regenerar”.

2. Para crear una, haz clic en “Nueva API Key”. En la ventana Nueva API Key, dale un nombre que identifique la integración (por ejemplo, “Integración ERP”) y haz clic en “Avanzar”.

3. Assin muestra la Public Key y la Secret Key, con botones para copiarlas. La Secret Key solo se muestra una vez: copia y guarda las dos en un lugar seguro antes de hacer clic en “Cerrar”. Quien tiene las claves accede a la cuenta de tu empresa.
4. En Acciones puedes:
- Activar clave / Desactivar clave: enciende o apaga el uso de la clave sin eliminarla.
- Regenerar clave: genera nuevas credenciales en lugar de las actuales, después de una confirmación. La acción no se puede deshacer y las integraciones que usan la clave antigua deben actualizarse.
- Eliminar clave: quita la clave definitivamente. Para confirmar, escribe el nombre de la clave en la ventana Quitar API Key.
Buenas prácticas: crea una clave por integración, nunca compartas la clave por correo o chat y desactiva las que no uses más. Las solicitudes se hacen por la API pública de Assin (documentación disponible para tu equipo de desarrollo). Cuando se crea una nueva clave, Assin también envía un correo de aviso (consulta Correos que envía Assin).
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.
5. En Integraciones > Webhook (pantalla Destinos de evento), la lista muestra la URL del endpoint, la Descripción y las Acciones (editar y eliminar).

6. Haz clic en “Nuevo endpoint”. En la ventana Crear nuevo endpoint, informa la URL del endpoint 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, una dirección de la red interna ni contener usuario y contraseña.

7. Usa el lápiz (Editar endpoint) para cambiar y la papelera (Eliminar endpoint) para eliminar (la plataforma pregunta “¿Deseas eliminar este endpoint?”). Al abrir un endpoint también ves el historial de entregas, con hora y dirección IP.
Quien integra por la API pública puede además elegir los eventos de cada webhook (sobre finalizado, sobre cancelado, sobre vencido y firma de cada firmante), definir encabezados personalizados (por ejemplo, para autenticación) y reprocesar entregas que fallaron.
Puntos de atención:
- Tu servidor debe responder con éxito (código 2xx) en hasta 10 segundos 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 reenviar las entregas que fallaron, usa el reprocesamiento de la API pública.
Para más información visita nuestro sitio https://assin.com.br/
¿Viste qué simple es Assin?
Assin Firma Digital
Te resulto util este articulo?
Gracias por tu opinion!
¿No encontraste lo que buscabas?
Nuestro equipo responde de lunes a viernes, en horario comercial. Cuenta con nosotros.