Come usare l'API di Papo per gestire le caselle di ingresso (connessioni)

Con l'API REST di Papo, puoi elencare le caselle di ingresso esistenti e creare nuove connessioni per canali come WhatsApp e Instagram — tutto tramite richieste autenticate, senza aprire il pannello. È il modo programmatico per provisionare canali di assistenza, integrare sistemi esterni e mantenere l'operazione multicanale allineata con l'automazione.

L'API di Papo espone risorse per le caselle di ingresso che consentono di consultare la configurazione attuale e aggiungere nuovi canali. Così, team IT, integratori e rivenditori white label riescono a gestire connessioni in blocco, replicare setup tra account e automatizzare l'attivazione dei canali senza dipendere dall'interfaccia.

Riepilogo delle operazioni sulle caselle di ingresso via API

Come funziona l'autenticazione dell'API

Tutte le chiamate all'API, inclusa l'elencazione delle caselle, richiedono la chiave segreta dell'account. Deve essere inviata come token Bearer nell'header Authorization. La chiave pubblica dell'account è opzionale, ma, se inviata, deve corrispondere allo stesso account della chiave segreta.

L'URL di base dell'API è https://app.papo.global/api/v1. Le chiavi vengono generate nell'area sviluppatori del pannello di Papo. La chiave segreta appare una sola volta alla creazione; conservala in un luogo sicuro e revocala se sospetti una fuga di dati.

Per validare l'autenticazione, puoi chiamare l'endpoint GET /api/v1/me, che restituisce i dati dell'account. Lo schema di autenticazione è lo stesso usato in tutti gli altri endpoint:

curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"

Come gestire le caselle di ingresso in pratica

1. Accedi all'area sviluppatori/API nel pannello di Papo e genera una chiave segreta. Copia anche la chiave pubblica dell'account.
2. In ogni richiesta, autenticati con la chiave segreta come token Bearer. Se vuoi rafforzare la validazione, invia la chiave pubblica nell'header X-Papo-Public-Key.
3. Per elencare le caselle di ingresso, chiama l'endpoint di elencazione delle caselle. La risposta contiene l'identificatore di ogni casella, il canale configurato e altre proprietà, permettendoti di mappare ciò che esiste già prima di crearne di nuove.
4. Per creare una nuova casella, invia un payload JSON con le informazioni del canale desiderato — ad esempio, WhatsApp (API ufficiale di Meta), Instagram, e‑mail o Telegram. Includi il nome della casella e gli identificatori degli agenti che devono avere accesso. Consulta la documentazione ufficiale per il formato esatto dei campi e dei valori accettati.
5. Dopo la creazione, la casella è disponibile immediatamente nel pannello e inizia a ricevere messaggi non appena la connessione del canale viene completata (nel caso di canali che richiedono l'abbinamento, come WhatsApp, l'API restituisce le istruzioni necessarie).

Poiché l'API è REST e utilizza JSON, qualsiasi linguaggio con supporto HTTP può essere usato per integrare la gestione delle caselle in script, strumenti di automazione (come n8n) o sistemi di provisioning. La documentazione ufficiale su https://papo.global/pt/docs contiene i dettagli di autenticazione, parametri, risposte ed esempi di codice.

Per chi ha senso questa integrazione

• Team IT che provisionano canali in blocco per nuove unità, franchising o marchi, senza dover accedere al pannello uno per uno.
• Rivenditori white label che desiderano automatizzare la creazione di caselle per ogni nuovo cliente, mantenendo la configurazione standardizzata.
• Operazioni che migrano o replicano configurazioni tra account, usando l'elencazione per verificare e la creazione per rispecchiare i canali.
• Integratori che collegano Papo a sistemi esterni di gestione dei canali, garantendo che l'ambiente di assistenza rifletta automaticamente le modifiche.

Domande frequenti

Serve la chiave segreta per elencare le caselle di ingresso?

Sì. L'elencazione delle caselle richiede l'autenticazione con la chiave segreta dell'account, poiché restituisce informazioni sensibili della configurazione. Lo schema è lo stesso delle altre chiamate all'API: invia il token Bearer nell'header Authorization.

Posso creare una casella di ingresso per WhatsApp via API?

Sì. Quando crei una casella, indichi il tipo di canale desiderato — incluso WhatsApp (API ufficiale di Meta) e altri canali supportati. Il payload deve seguire il formato previsto per il canale scelto, in base alla documentazione ufficiale.

È possibile aggiornare una casella di ingresso esistente tramite API?

L'API attuale consente di elencare e creare caselle di ingresso. Per modificare le configurazioni di una casella esistente (come cambiare agenti o rinominare), puoi usare il pannello di Papo o, se necessario, ricreare la casella con i nuovi parametri.

Come associo gli agenti a una casella durante la creazione?

Nel payload di creazione, puoi indicare gli identificatori degli agenti che devono avere accesso alla casella. Questi ID possono essere ottenuti tramite l'API di team e membri. Consulta la documentazione per il formato esatto.

L'autenticazione è la stessa usata negli altri endpoint di Papo?

Sì. Tutte le chiamate che accedono alle risorse dell'account utilizzano la chiave segreta come token Bearer. La chiave pubblica è opzionale e, se inviata, deve corrispondere allo stesso account.

Dove trovo i percorsi esatti e il formato del payload?

Nella documentazione ufficiale dell'API, disponibile su https://papo.global/pt/docs. Lì trovi i dettagli di autenticazione, parametri, risposte ed esempi di codice per le caselle di ingresso e le altre risorse.

Leggi anche

• Come usare l'API di Papo per gestire team e membri
• Come usare l'API di Papo per creare e gestire etichette (tag)

Inizia ad automatizzare le tue connessioni subito →

Crea il tuo account gratuito e integra i canali via API senza aprire il pannello.