Introduzione
Le conversazioni inbox Buzzbip corrispondono a record contatto. Non esiste ancora un endpoint REST JWT pubblico per assegnare un agente. Il meccanismo piรน vicino รจ POST /inbox/v2/assign (API inbox con sessione): conversation_id (id contatto), new_assignee_id e internal_note opzionale.
Passaggi
Segui questo flusso per assegnare una conversazione dalla tua integrazione.
- Autenticati: POST /api/login_check per JWT (lookup contatti) e mantieni un cookie di sessione Buzzbip per le route inbox.
- Trova la conversazione: GET /api/contacts/?number=21696816277 โ conversation_id รจ l'id contatto Buzzbip.
- Elenca agenti (opzionale): GET /inbox/v2/agents con cookie sessione per new_assignee_id.
- Assegna: POST /inbox/v2/assign con conversation_id, new_assignee_id e internal_note opzionale.
- Verifica: conferma assigned_agent_id nella risposta JSON o rifai GET /api/contacts/.
Esempio di codice
Assegna una conversazione contatto all'agente id 42. Richiede sessione Buzzbip attiva (Cookie) โ non solo Bearer JWT.
curl -X POST 'https://app.buzzbip.com/inbox/v2/assign' \
-H 'Content-Type: application/json' \
-H 'Cookie: PHPSESSID=your_session_cookie' \
-d '{"conversation_id": 745808, "new_assignee_id": 42, "internal_note": "VIP customer"}'Suggerimento: conversation_id equivale all'id contatto da GET /api/contacts/. Passa new_assignee_id: null per rimuovere l'assegnazione.
Prossimi passi
Pagine correlate: api/contacts guides/send-whatsapp-message api/v1/automations
