Costruisci sopra PinsCorner: API REST, GraphQL e webhook

Una scheda di visita digitale vale quanto le connessioni che stabilisce con il resto dei tuoi strumenti. Quando qualcuno scansiona la tua scheda e lascia i propri dati, quel contatto dovrebbe arrivare nel tuo CRM in pochi secondi — non aspettare che tu ricordi di esportare un CSV. PinsCorner è costruito su Payload CMS, il che significa che l'intero livello dati è esposto attraverso una API REST e GraphQL nativa, affiancata da un sistema di webhook per la consegna di eventi in tempo reale.

Che tu gestisca una consulenza individuale, coordini un team di vendita o sviluppi prodotti per clienti, il livello API e webhook trasforma PinsCorner in un nodo attivo della tua infrastruttura aziendale — molto più di un semplice strumento per condividere schede.

REST e GraphQL: due modi per accedere ai tuoi dati

PinsCorner offre accesso REST e GraphQL, autenticato con chiavi API che generi dalle impostazioni del tuo account. REST è adatto a script, integrazioni backend e servizi che seguono già il classico pattern richiesta-risposta. GraphQL si adatta meglio ad applicazioni front-end o a scenari in cui vuoi recuperare esattamente i campi di cui hai bisogno, senza sovraccaricare la rete o moltiplicare le chiamate.

Tramite l'API puoi leggere e scrivere schede, contatti, lead, membri del team e molto altro. Questo ti permette di costruire dashboard interni che mostrano le analytics delle tue schede accanto alle altre metriche aziendali, sincronizzare i dati in un data warehouse per analisi approfondite, oppure generare schede in modo programmatico quando onboardi nuovi membri del team su larga scala.

• Genera chiavi API per utente o per integrazione, con controllo delle autorizzazioni
• Interroga qualsiasi collection — schede, lead, contatti, team — via REST o GraphQL
• Scrivi su PinsCorner: crea o aggiorna schede e contatti da sistemi esterni
• Usa GraphQL per richiedere solo i campi necessari e ridurre il peso delle risposte
• Accedi alla documentazione dello schema generata automaticamente dal tuo pannello di controllo

Webhook firmati: reagisci nell'istante in cui accade tutto

Per elaborazioni batch, interrogare periodicamente un'API può bastare. Ma per tutto ciò che è sensibile al tempo — un nuovo lead, una visualizzazione di scheda, un contatto salvato — hai bisogno di un push. PinsCorner invia webhook firmati HMAC all'endpoint che configuri, così il tuo backend riceve la notifica nel momento stesso in cui si verifica l'evento.

La firma HMAC garantisce che ogni payload porti una firma calcolata a partire da un segreto condiviso. Il tuo server verifica quella firma prima di elaborare l'evento, assicurando che la richiesta provenga davvero da PinsCorner e non sia stata alterata durante il transito. È lo stesso meccanismo usato da Stripe e GitHub: semplice, robusto e affidabile senza esporre il tuo endpoint a chiunque.

• Lead acquisito: scatta quando un visitatore invia il modulo di acquisizione su qualsiasi scheda
• Eventi scheda: visualizzazioni, contatti salvati e scansioni QR
• Configura uno o più endpoint per tipo di evento
• Verifica la firma HMAC nel tuo handler prima di elaborare il payload
• Meccanismo di nuovo tentativo automatico in caso di mancata consegna

Chi ne trae più vantaggio

Il livello API e webhook è concretamente utile per una vasta gamma di team. I team di vendita possono instradare ogni lead acquisito direttamente nel proprio CRM — HubSpot, Salesforce, Pipedrive — senza alcun intervento umano. I team di marketing possono attivare sequenze email automatizzate nel momento in cui qualcuno salva una scheda. Gli sviluppatori che costruiscono prodotti white-label per clienti possono gestire centinaia di schede in modo programmatico, mantenendo il proprio sistema di riferimento sincronizzato con PinsCorner.

Le agenzie e i costruttori SaaS traggono un vantaggio particolare dallo schema nativo di Payload: poiché PinsCorner è costruito su Payload CMS, l'API non è uno strato aggiunto a posteriori. È lo stesso strato usato dal pannello di amministrazione — completo, documentato e stabile.

Le migliori integrazioni sono quelle a cui non devi più pensare: i dati fluiscono da soli, i lead arrivano dove devono, e il tuo team dedica il tempo alle conversazioni, non al copia-incolla di contatti.

Come iniziare

Per collegare un sistema esterno, genera una chiave API dalle impostazioni del tuo account PinsCorner, consulta la documentazione dello schema REST o GraphQL generata automaticamente e configura un endpoint webhook per gli eventi che ti interessano. La maggior parte delle integrazioni si implementa in meno di un'ora. Strumenti no-code come Make o Zapier possono consumare i webhook, quindi non hai bisogno di uno sviluppatore per sfruttare l'instradamento dei lead in tempo reale.

Se sei pronto a integrare PinsCorner nel tuo stack, la documentazione API è disponibile all'interno del tuo pannello di controllo. Inizia con un account gratuito e passa a un piano Pro o Team quando hai bisogno di limiti di frequenza più elevati e di una cronologia completa dei webhook.