Come gestire i messaggi programmati tramite API | Everything about Papo Global.

Con l'API REST di Papo (https://papo.global/), automatizzi la creazione, l'elenco e la cancellazione dei messaggi programmati per WhatsApp e SMS, integrando la programmazione delle comunicazioni direttamente nei tuoi sistemi, CRM o flussi di automazione — senza dover accedere manualmente al pannello.

La piattaforma Papo offre già un'area centralizzata per gestire i messaggi programmati, ma quando il volume delle programmazioni è alto o quando hai bisogno che un altro software avvii gli invii, l'API è la strada. Con essa, è possibile creare promemoria, follow-up e notifiche in modo programmatico, mantenendo lo stesso controllo che avresti nell'interfaccia visiva.

Riepilogo delle operazioni sui messaggi programmati tramite API

Operazione	Cosa fa	Quando usare
Creare programmazione	Programma un messaggio WhatsApp o SMS per un contatto in una data e ora specifiche.	Programmare promemoria di appuntamenti, follow-up di vendita o notifiche di sollecito da un sistema esterno.
Elencare programmazioni	Restituisce tutti i messaggi programmati, con possibilità di filtrare per stato (in sospeso, inviato, annullato, non riuscito).	Sincronizzare l'agenda degli invii con una dashboard, verificare le attività in sospeso prima di creare nuove programmazioni o controllare le comunicazioni programmate.
Annullare programmazione	Annulla un invio programmato prima dell'orario di invio.	Interrompere un messaggio non più rilevante, come un promemoria di un evento annullato o un follow-up che ha perso senso.

Come funziona l'integrazione

L'API di Papo segue lo standard REST e utilizza l'autenticazione tramite token Bearer. Tutte le operazioni di scrittura (creazione e annullamento) richiedono la chiave segreta del tuo account, generata nell'area sviluppatore del pannello. L'URL di base è https://app.papo.global/api/v1.

Per usare le funzionalità dei messaggi programmati:

Genera una chiave segreta nel pannello di Papo (area sviluppatore/API). Conservala in un luogo sicuro — viene mostrata una sola volta.
In ogni richiesta, includi l'header Authorization: Bearer {tua_chiave_segreta}.
Utilizza gli endpoint specifici per i messaggi programmati, come da documentazione ufficiale su https://papo.global/pt/docs. Lì trovi i percorsi esatti, i parametri obbligatori (come ID del contatto, canale, contenuto, data/ora) e esempi di payload in formato JSON.
Per elencare le programmazioni, puoi applicare filtri per stato, permettendo di consultare solo gli invii in sospeso o già completati.

L'API riflette il comportamento del modulo Messaggi programmati della piattaforma: le programmazioni create tramite API appaiono nell'elenco del pannello, e qualsiasi annullamento effettuato tramite API aggiorna lo stato immediatamente.

A chi è indicata questa automazione

Sviluppatori e team IT che devono integrare la programmazione dei messaggi in sistemi proprietari, come ERP, CRM o piattaforme di prenotazione di appuntamenti.
Rivenditori white label che desiderano offrire ai propri clienti la possibilità di programmare invii tramite API, ampliando il valore della soluzione.
Operazioni con alto volume di follow-up (vendite, solleciti di pagamento, conferma di presenza) che vogliono automatizzare la creazione di promemoria senza intervento manuale.
Aziende che utilizzano flussi di automazione e avviano la creazione di programmazioni a partire da eventi in altri strumenti.

Domande frequenti

Devo avere il modulo Messaggi programmati attivo per usare l'API?

Sì. L'API opera sulla stessa funzionalità che trovi nel pannello. Se il modulo è disponibile nel tuo piano, anche gli endpoint corrispondenti saranno accessibili.

L'API consente di programmare messaggi con allegati o media?

La documentazione ufficiale dettaglia i tipi di contenuto supportati. Attualmente, la programmazione tramite piattaforma è orientata ai messaggi di testo. Consulta il riferimento API per verificare se è supportato il media al momento della tua integrazione.

Come faccio ad autenticare le richieste?

Utilizza la chiave segreta del tuo account Papo come token Bearer nell'header Authorization. La chiave viene generata nell'area sviluppatore del pannello.

Posso programmare messaggi per più contatti in una sola volta?

L'API consente di creare una programmazione per richiesta. Per più contatti, puoi effettuare chiamate sequenziali. Verifica nella documentazione se esistono endpoint batch per il tuo caso d'uso.

Cosa succede se provo ad annullare un messaggio già inviato?

L'API restituirà un errore, poiché solo le programmazioni con stato in sospeso possono essere annullate. Dopo l'invio, il messaggio non può più essere modificato.

Dove trovo le chiavi API?

Nel pannello di Papo, accedi all'area sviluppatore o alle configurazioni API. La chiave segreta viene mostrata al momento della creazione; se persa, sarà necessario generarne una nuova.