Conecta PinsCorner a tu stack: API REST, GraphQL y webhooks

Una tarjeta de visita digital vale lo que valen las conexiones que establece con el resto de tus herramientas. Cuando alguien escanea tu tarjeta y deja sus datos, ese contacto debería llegar a tu CRM en segundos, no esperar a que exportes un CSV a fin de mes. PinsCorner está construido sobre Payload CMS, lo que significa que toda la capa de datos queda expuesta a través de una API REST y GraphQL nativa, junto con un sistema de webhooks para entrega de eventos en tiempo real.

Tanto si llevas una consultoría unipersonal como si gestionas un equipo de ventas o desarrollas productos para clientes, la capa de API y webhooks convierte PinsCorner en un nodo activo de tu infraestructura de negocio, no solo en una tarjeta bonita para compartir.

REST y GraphQL: dos formas de acceder a tus datos

PinsCorner ofrece acceso por REST y por GraphQL, autenticado con claves de API que generas desde los ajustes de tu cuenta. REST es ideal para scripts, integraciones backend y servicios que ya siguen el patrón petición-respuesta convencional. GraphQL encaja mejor en aplicaciones front-end o cuando quieres recuperar exactamente los campos que necesitas, sin lecturas innecesarias ni múltiples peticiones.

A través de la API puedes leer y escribir tarjetas, contactos, leads, miembros de equipo y más. Esto te permite construir dashboards internos que muestren las analíticas de tus tarjetas junto al resto de métricas de negocio, sincronizar datos con un data warehouse para informes avanzados, o generar tarjetas programáticamente cuando incorporas nuevos miembros al equipo de forma masiva.

• Genera claves de API por usuario o por integración, con control de permisos
• Consulta cualquier colección — tarjetas, leads, contactos, equipos — vía REST o GraphQL
• Escribe de vuelta en PinsCorner: crea o actualiza tarjetas y contactos desde sistemas externos
• Usa GraphQL para pedir solo los campos que tu cliente necesita y reducir el tamaño de la respuesta
• Accede a la documentación de esquema generada automáticamente desde tu panel de control

Webhooks firmados: reacciona al instante

Para procesos batch, hacer polling a una API puede ser suficiente. Pero para todo lo que requiere rapidez — un lead nuevo, una visualización de tarjeta, un contacto guardado — necesitas push. PinsCorner envía webhooks firmados con HMAC al endpoint que configures, de modo que tu backend recibe la notificación en el mismo momento en que ocurre el evento.

La firma HMAC garantiza que cada payload lleva una firma calculada a partir de un secreto compartido. Tu servidor verifica esa firma antes de procesar el evento, lo que asegura que la petición proviene realmente de PinsCorner y no ha sido alterada en tránsito. Es el mismo patrón que usan Stripe o GitHub: sencillo, robusto y de confianza sin exponer tu endpoint al mundo.

• Lead capturado: se dispara cuando un visitante envía el formulario de captación en cualquier tarjeta
• Eventos de tarjeta: visualizaciones, contactos guardados y escaneos de QR
• Configura uno o varios endpoints por tipo de evento
• Verifica la firma HMAC en tu handler antes de procesar el payload
• Reintentos automáticos en caso de fallo en la entrega

Quién saca más partido a esta funcionalidad

La API y los webhooks son útiles para un abanico amplio de perfiles. Los equipos de ventas pueden enviar cada lead capturado directamente a su CRM — HubSpot, Salesforce, Pipedrive — sin intervención manual. Los equipos de marketing pueden disparar secuencias de email automatizadas en el momento en que alguien guarda una tarjeta. Los desarrolladores que crean productos de marca blanca para clientes pueden gestionar cientos de tarjetas programáticamente, manteniendo su propio sistema de registro sincronizado con PinsCorner.

Las agencias y los constructores de SaaS se benefician especialmente del esquema nativo de Payload: como PinsCorner está construido sobre Payload CMS, la API no es una capa añadida a posteriori, sino la misma que usa el panel de administración. Eso se traduce en una API completa, documentada y estable.

Las mejores integraciones son las que no tienes que pensar: los datos fluyen solos, los leads llegan donde deben, y tu equipo dedica el tiempo a conversaciones, no a copiar y pegar contactos.

Cómo empezar

Para conectar un sistema externo, genera una clave de API desde los ajustes de tu cuenta de PinsCorner, revisa la documentación de esquema REST o GraphQL generada automáticamente, y configura un endpoint de webhook para los eventos que te interesan. La mayoría de las integraciones se montan en menos de una hora. Herramientas no-code como Make o Zapier también pueden consumir los webhooks, así que no necesitas un desarrollador para aprovechar el enrutamiento de leads en tiempo real.

Si estás listo para integrar PinsCorner en tu stack, la documentación de la API está disponible dentro de tu panel de control. Empieza con una cuenta gratuita y actualiza al plan Pro o Team cuando necesites límites de tasa más altos e historial completo de webhooks.