Con l'API REST di Papo, puoi automatizzare l'amministrazione dei team senza aprire il pannello: elencare team, creare team, elencare i membri di un team, aggiungere utenti a un team ed elencare o creare caselle di posta. È il modo programmatico per mantenere la struttura di assistenza sincronizzata con sistemi esterni, grandi operazioni e rivendite white label.
L'API di Papo espone risorse di team e caselle con la stessa autenticazione degli altri endpoint della piattaforma. Con esse, il tuo team può provisionare nuove strutture, verificare chi fa parte di ogni gruppo e preparare il routing delle conversazioni senza intervento manuale nel pannello.
Riepilogo delle operazioni di team e membri via API
| Operazione | Cosa fa | Quando usare |
|---|---|---|
| Elencare team | Restituisce i team registrati nell'account. | Verificare la struttura prima di creare un nuovo team. |
| Creare team | Crea un team con nome e descrizione opzionale. | Provisionare un nuovo team tramite script, ERP o CRM. |
| Elencare i membri di un team | Restituisce gli utenti che fanno parte di quel team. | Controllare chi è incluso ed evitare accessi errati. |
| Aggiungere utenti al team | Include uno o più utenti indicando gli ID separati da virgola. | Sincronizzare il team con l'organico attuale di agenti. |
| Elencare caselle | Restituisce le caselle con il canale, nella vista amministratore. | Controllare i canali disponibili e come sono organizzati. |
| Creare casella di posta | Crea una nuova casella di posta. | Provisionare nuovi canali insieme alla struttura dei team. |
Come funziona l'autenticazione dell'API
Le operazioni di scrittura, incluse quelle di team e membri, richiedono la chiave segreta dell'account. Deve essere inviata come token Bearer nell'header di autorizzazione. 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 sviluppatore 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.
Passo passo per gestire team e membri via API
- Accedi all'area sviluppatore/API nel pannello di Papo e genera una chiave segreta. Copia anche la chiave pubblica dell'account se desideri una validazione aggiuntiva.
- In ogni richiesta, autentica con la chiave segreta come token Bearer. Se rafforzi la validazione, invia la chiave pubblica nell'header indicato nella documentazione.
- Elenca i team esistenti per mappare la struttura attuale prima di crearne di nuovi.
- Crea un team inviando un payload JSON con nome e, se necessario, descrizione. Consulta la documentazione ufficiale per il formato esatto.
- Elenca i membri del team per verificare chi è già incluso ed evitare duplicati.
- Aggiungi utenti al team indicando gli ID separati da virgola. Questo passaggio sincronizza il team con l'organico attuale di agenti.
- Elenca le caselle di posta con la vista amministratore per controllare i canali esistenti e usare l'API anche per creare caselle quando necessario.
Poiché l'API è REST e utilizza JSON, qualsiasi linguaggio con supporto HTTP può essere usato per integrare team e membri in script, ERP, CRM o strumenti di automazione. La documentazione ufficiale su https://papo.global/pt/docs fornisce i dettagli su autenticazione, parametri, risposte ed esempi di codice.
Per chi ha senso questa integrazione
- Operazioni grandi che devono creare e modificare team frequentemente senza aprire manualmente il pannello.
- Team IT e automazione che sincronizzano la struttura degli agenti con directory, risorse umane o sistemi interni.
- Rivendite white label che provisionano account clienti in modo standardizzato, riutilizzando la stessa logica di team e caselle.
- Aziende che già usano l'API di Papo per contatti e conversazioni e desiderano completare il flusso con l'amministrazione dei team.
L'API gestisce la struttura dei team e l'inclusione dei membri. I ruoli utente, come Agente o Amministratore, e i permessi granulari continuano a essere definiti nel pannello. Aggiungendo un utente a un team e collegandolo alle caselle di posta pertinenti, controlli l'accesso operativo alle conversazioni.
Domande frequenti
L'API di Papo definisce il ruolo dell'utente, come Agente o Amministratore?
No. L'API di team e membri si concentra sulla creazione di team, sull'elenco dei membri e sull'inclusione degli utenti. La definizione del ruolo e dei permessi di ciascun utente viene fatta nel pannello. Includendo un utente in un team e nelle caselle corrette, limiti l'accesso alle conversazioni operative.
Posso creare un team senza aggiungere membri nello stesso passaggio?
Sì. L'API permette di creare un team con nome e descrizione opzionale, senza includere utenti immediatamente. Successivamente, puoi aggiungere membri usando l'operazione di inclusione in blocco.
Come identifica l'API l'account nelle richieste?
Tramite la chiave segreta inviata come token Bearer. La chiave pubblica è opzionale e, se inviata, deve corrispondere allo stesso account della chiave segreta.
Questa API funziona per la rivendita white label?
Sì. I rivenditori possono usare l'API per provisionare team e membri negli account dei clienti in modo standardizzato, riducendo la configurazione manuale e mantenendo la coerenza tra le operazioni.
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 su autenticazione, parametri, risposte ed esempi di codice per team, membri e altre risorse.
Leggi anche
- Come usare l'API di Papo per creare e gestire etichette (tag)
- Come gestire utenti e permessi nella tua piattaforma white label
Inizia gratis e automatizza team e membri via API →
Il primo utente è gratis per sempre, così puoi validare l'integrazione prima di strutturare la tua operazione.