API y Webhooks
Pestañas
La página de API y Webhooks es donde tu equipo gestiona las herramientas para conectar PlatoForms con servicios externos: puntos finales de webhook que envían envíos de formularios a otros sistemas, aplicaciones OAuth2 para integraciones de terceros y tokens de larga duración para llamadas API de servidor a servidor. Este capítulo explica cómo acceder a la página y configurar cada uno de estos.
Acceder a la página de API y Webhooks
-
Inicia sesión en tu Panel de Control.
-
En la barra lateral izquierda, haz clic en el nombre de tu equipo para abrir el menú del equipo.
-
Selecciona API y Webhooks de la lista.
Lo que verás según tus permisos
Si tienes acceso
La página se abre directamente en URL de API y Tokens, donde puedes ver y gestionar tus webhooks, aplicaciones OAuth2 y tokens.
Los administradores del equipo siempre tienen acceso directo a esta página.
Si no tienes acceso
API y Webhooks se muestra con un icono de candado y una etiqueta de “Solicitar acceso al administrador”.
Haz clic en Solicitar acceso al administrador para enviar una solicitud.
El administrador de tu equipo recibe un correo electrónico notificándole de la solicitud. Una vez que se concede el acceso, podrás abrir API y Webhooks desde el menú de tu propio equipo.
Configurar puntos finales de Webhook
Configura puntos finales para recibir notificaciones en tiempo real cuando se envían formularios u ocurren otros eventos. Útil para integrar datos de formularios en otras aplicaciones o servicios.
Haz clic en + Añadir punto final para crear uno nuevo, o en el icono de edición junto a un punto final existente para modificarlo.
Al añadir o editar un punto final, puedes configurar:
| Campo | Descripción |
|---|---|
| Nombre | Una etiqueta para ayudarte a identificar el punto final. |
| URL de WebHook | La URL que recibirá la solicitud POST. |
| Formulario de destino | Elige Todos los Formularios para activar el webhook para cualquier envío de formulario, o selecciona un formulario específico. |
| Incluir enlaces compartibles | Incluye enlaces de envío compartibles en la carga útil. |
| Datos de envío como Dict (en lugar de Lista) | Cambia la estructura de los datos de envío en la carga útil. |
| Hook instantáneo (Sin esperar la creación del PDF) | Activa el webhook inmediatamente en lugar de esperar a que se genere el PDF del envío. |
| Excluir datos de firma de la carga útil | Omite los datos de firma de la carga útil. |
| Webhook habilitado | Activa o desactiva el punto final sin eliminarlo (disponible al editar un punto final existente). |
Haz clic en Guardar para aplicar tus cambios, o en Eliminar para quitar el punto final por completo.
Crear una Aplicación OAuth2
Las APIs de PlatoForms están protegidas por el protocolo OAuth2, un marco seguro de autenticación y autorización. Una “Aplicación OAuth2” se refiere a una aplicación registrada que utiliza OAuth 2.0 para interactuar con el sistema.
Al crear una aplicación OAuth2, puedes obtener de manera segura un ID de Cliente y un Secreto de Cliente a través de un proceso de autenticación. Esto, a su vez, facilita la autorización segura de otras aplicaciones para acceder a la API de la plataforma. La creación de una ‘Aplicación OAuth2’ configura los componentes esenciales para una integración segura, permitiendo interacciones con la API usando OAuth2 tanto para autenticación como para autorización.
Para crear una Aplicación OAuth2:
-
Haz clic en + Añadir aplicación.
-
En la ventana que se abre:
-
Proporciona un Nombre para tu aplicación, lo cual ayuda a identificarla dentro del sistema.
-
Especifica una URL de Redirección, que es crucial para el flujo de OAuth2.
-
-
Confirma tus configuraciones haciendo clic en Guardar.
Una vez que la aplicación se guarda, el sistema genera un ID de Cliente y un Secreto de Cliente únicos.
Crear y restablecer tu token
Si eres un desarrollador que requiere acceso prolongado a la API, la plataforma ofrece la capacidad de crear y restablecer el Token sin caducidad de tu equipo. Esta función elimina la necesidad de una actualización regular del token, asegurando un acceso ininterrumpido y extendido a la API para solicitudes de servidor a servidor. Cada equipo tiene un único token sin caducidad.
Simplemente haz clic en Crear o restablecer para generar el token, y usa Eliminar para quitarlo cuando sea necesario. Esta funcionalidad simplifica el proceso de gestión del acceso a largo plazo a la API.
Trata los tokens, ID de Cliente y Secretos de Cliente como contraseñas. Cualquiera con acceso a ellos puede acceder a los datos de tu equipo.
Si prefieres trabajar con tus formularios de forma conversacional a través de un asistente de IA — sin escribir código — consulta Asistente de IA (MCP).