Conversation Assignment
Assegna le conversazioni in entrata ai membri del team e gestisci l'assegnatario.
Elenca gli utenti assegnabili alle conversazioni
Restituisce l'elenco dei membri del team della tua azienda che possono essere assegnati a una conversazione. Usalo per popolare un selettore di assegnatari nella tua applicazione prima di chiamare l'endpoint di assegnazione. Ogni voce include l'ID utente richiesto come input da POST /conversations/{chatId}/assignee, il nome visualizzato e un URL dell'avatar opzionale. Restituisce 401 se la chiave API è mancante o non valida. Restituisce 502 se il servizio upstream dei profili utente è temporaneamente non disponibile; è una condizione transitoria e la richiesta può essere ritentata in sicurezza dopo una breve attesa.
Recupera una singola conversazione
Restituisce i metadati completi di una singola conversazione, incluso l'assegnatario corrente, il contatore dei non letti, l'anteprima dell'ultimo messaggio e le informazioni sul canale. Usalo per aggiornare i dettagli di una conversazione specifica senza dover ri-elencare l'intera posta in arrivo (ad esempio dopo averla assegnata o disassegnata). Restituisce 404 se la conversazione non esiste o non appartiene al tuo account. Restituisce 401 se la chiave API è mancante o non valida.
Rimuovi l'assegnatario da una conversazione
Rimuove l'assegnatario corrente della conversazione, lasciandola senza assegnatario. La conversazione stessa rimane attiva e continua ad apparire nella posta in arrivo; viene rimosso solo il legame di proprietà con uno specifico membro del team. Questa operazione è idempotente: chiamarla su una conversazione che non ha assegnatario ha successo e restituisce comunque 204. Restituisce 404 se la conversazione non esiste o non appartiene al tuo account. Restituisce 401 se la chiave API è mancante o non valida.
Assegna una conversazione a un membro del team
Assegna la conversazione specificata a un utente della tua azienda. L'assegnatario diventa il proprietario principale della conversazione e riceverà le notifiche per i nuovi messaggi in entrata. Una conversazione può avere al massimo un assegnatario — chiamare questo endpoint sostituisce qualsiasi assegnazione esistente. Per rimuovere l'assegnatario senza sostituirlo, usa DELETE sulla stessa risorsa. L'utente assegnato deve appartenere alla tua azienda; l'assegnazione cross-company non è supportata e genera un 404. Restituisce 400 se il corpo della richiesta è mancante o `userId` è null. Restituisce 404 se la conversazione o l'utente di destinazione non esistono o non appartengono al tuo account. Restituisce 401 se la chiave API è mancante o non valida.