Con l'API REST di Papo, puoi elencare le etichette esistenti, creare nuove etichette e applicare un'etichetta a un contatto con conversazione aperta — tutto tramite richieste autenticate, senza aprire il pannello. È il modo programmatico per automatizzare la categorizzazione e l'organizzazione del servizio da sistemi esterni, CRM o strumenti di automazione.
L'API di Papo espone risorse di Conversazioni che includono la gestione delle etichette. Con esse, il tuo team può mantenere una tassonomia coerente, preparare categorie prima delle campagne e classificare contatti e conversazioni in tempo reale, usando la stessa autenticazione degli altri endpoint della piattaforma.
Riepilogo delle operazioni sulle etichette via API
| Operazione | Cosa fa | Quando usare |
|---|---|---|
| Elenca etichette | Restituisce le etichette registrate nell'account, con nome e colore per l'identificazione visiva. | Verificare la standardizzazione dell'account o sincronizzare le etichette con un altro strumento. |
| Crea etichetta | Crea un'etichetta nell'account senza applicarla a un contatto. | Preparare nuove categorie prima di applicarle in massa o in automazioni. |
| Applica etichetta a contatto + conversazione | Crea l'etichetta se non esiste ancora e la applica al contatto e alla conversazione aperta. | Automatizzare la selezione, la qualificazione o la classificazione non appena arriva la conversazione. |
Come funziona l'autenticazione dell'API
Tutte le rotte di scrittura, incluse le operazioni sulle etichette, 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.
Come usare nella pratica
- Accedi all'area sviluppatore/API nel pannello di Papo e genera una chiave segreta. Copia anche la chiave pubblica dell'account.
- In ogni richiesta, autenticati con la chiave segreta come token Bearer. Se vuoi rafforzare la validazione, invia la chiave pubblica nell'header indicato nella documentazione.
- Per elencare le etichette, chiama l'endpoint di elenco delle etichette dell'API. La risposta contiene le etichette registrate, permettendoti di mappare ciò che esiste già prima di crearne di nuove.
- Per creare un'etichetta senza applicarla, invia un payload JSON con le informazioni dell'etichetta nell'endpoint di creazione. Consulta la documentazione ufficiale per il formato esatto.
- Per applicare un'etichetta a un contatto con conversazione aperta, chiama l'endpoint di etichettatura. Se l'etichetta non esiste ancora, verrà creata automaticamente e applicata al contatto e alla conversazione aperta.
Poiché l'API è REST e utilizza JSON, qualsiasi linguaggio con supporto HTTP può essere usato per integrare le etichette 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
- Team che usano automazioni esterne per classificare le conversazioni senza aprire l'interfaccia di Papo.
- Operazioni che devono creare etichette in blocco prima delle campagne o quando implementano una nuova tassonomia di servizio.
- Integratori e rivenditori white label che collegano Papo ai sistemi dei clienti e vogliono mantenere una categorizzazione coerente tra gli account.
- Aziende che già usano l'API di Papo per contatti e messaggi e desiderano completare il flusso con le etichette.
Domande frequenti
Devo creare l'etichetta prima di applicarla via API?
No. L'API ha una risorsa che crea l'etichetta nell'account, se non esiste ancora, e la applica al contatto e alla conversazione aperta. Esiste anche l'opzione di creare solo l'etichetta, senza applicarla a nessun contatto.
L'etichetta applicata via API vale per il contatto e per la conversazione?
Sì. La risorsa di etichettatura applica l'etichetta al contatto e alla conversazione aperta, aiutando a classificare sia la cronologia del lead sia il servizio in corso.
L'autenticazione è la stessa usata in altri endpoint di Papo?
Sì. Le rotte di scrittura richiedono la chiave segreta dell'account, inviata 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ì ci sono i dettagli su autenticazione, parametri, risposte ed esempi di codice per etichette e altre risorse.
Posso usare l'API per classificare conversazioni vecchie in massa?
La risorsa di applicazione descritta nella piattaforma agisce sul contatto e sulla conversazione aperta. Per casi specifici di migrazione o classificazione retroattiva, l'ideale è consultare la documentazione ufficiale e combinare l'elenco delle conversazioni con chiamate in sequenza, quando il flusso lo consente.
Leggi anche
- Come usare l'API di Papo per creare e aggiornare contatti in massa
- Come usare l'API di Papo per inviare modelli di messaggio WhatsApp (HSM)
Crea il tuo account gratuito e centralizza WhatsApp, Instagram, e-mail e SMS in un'unica casella di posta, con etichette per organizzare il servizio.