Vai al contenuto principale
I Messaggi Diretti consentono conversazioni private su X. Sono una delle funzionalità più popolari di X, con un’ampia varietà di casi d’uso: dalle chat di gruppo tra amici all’assistenza clienti per brand in tutto il mondo. Le nuove versioni v2 degli endpoint dei Messaggi Diretti saranno introdotte in più fasi, e questa prima fase include endpoint fondamentali per creare Messaggi Diretti e per elencare gli eventi delle conversazioni di Messaggi Diretti. Per la prima volta, la X API v2 supporta conversazioni di gruppo. Questa versione iniziale di gestione dei Messaggi Diretti include tre metodi POST per creare Messaggi Diretti:
  • POST /2/dm_conversations/with/:participant_id/messages - Crea un Messaggio Diretto uno-a-uno. Questo metodo crea una nuova conversazione 1-1 oppure recupera la conversazione esistente e vi aggiunge il Messaggio Diretto. Il parametro di percorso :participant_id è l’id utente dell’account che riceve il messaggio.
  • POST /2/dm_conversations - Crea una nuova conversazione di gruppo e vi aggiunge un Messaggio Diretto. Queste richieste richiedono un elenco di partecipanti alla conversazione. Nota che puoi creare più conversazioni con lo stesso elenco di partecipanti. Queste richieste restituiranno sempre un nuovo id conversazione.
  • POST /2/dm_conversations/:dm_conversation_id/messages - Crea un Messaggio Diretto e lo aggiunge a una conversazione esistente. Il parametro di percorso :dm_conversation_id è l’id della conversazione a cui il messaggio verrà aggiunto.
Nota che gli id degli eventi dei Messaggi Diretti sono comuni tra v1.1 e v2 (così come nella X App), quindi i metodi v1.1 per nascondere/eliminare Messaggi Diretti possono essere usati insieme a questo nuovo endpoint v2. Nota anche che le Account Activity API Enterprise e Premium supportano i messaggi uno-a-uno v2, ma non supportano ancora le conversazioni di gruppo. È previsto un limite di velocità utente di 200 richieste per 15 minuti per il metodo POST. È inoltre previsto un limite di velocità di 1000 richieste per 24 ore per utente. Inoltre, è previsto un limite di velocità di 15000 richieste per 24 ore. Nota che questi limiti di velocità sono condivisi tra questi endpoint POST. Poiché stai effettuando richieste per conto di un utente con gli endpoint di gestione dei Post, devi autenticarti con OAuth 1.0a User Context o con OAuth 2.0 Authorization Code with PKCE e utilizzare un Access Token utente associato a un utente che ha autorizzato la tua App. Per generare questo Access Token utente con OAuth 1.0a, puoi utilizzare il flusso OAuth a 3 vie. Per generare un Access Token utente con OAuth 2.0, puoi utilizzare il Authorization Code with PKCE grant flow).
Configurazione dell’accountPer accedere a questi endpoint, ti serviranno:Scopri di più su come ottenere l’accesso agli endpoint della X API v2 nella nostra guida introduttiva.
⌘I