API Tutorial

Come inviare messaggi su X tramite API

Per inviare messaggi su X tramite API, collega X con Modiva e poi chiama `messages_send` con destinatario e testo — leggi la conversazione con `messages_list` per alimentare caselle di posta e risposte automatiche con l'IA.

La messaggistica programmatica su X di solito significa districarsi tra API di messaggistica specifiche della piattaforma e approvazioni. Modiva astrae tutto questo in `messages_send`, `messages_list` e `messages_inbox`, così una casella di posta unificata o un risponditore IA funziona su X esattamente come ovunque altrove.

Passo dopo passo

Crea un account Modiva e una chiave MCP

Registrati gratuitamente e genera una chiave MCP (`mk_live_…`) dalla dashboard. La stessa chiave autentica sia il server MCP ospitato (per gli agenti IA) sia la REST API (per il tuo backend), così gestisci un'unica credenziale.

Collega il tuo account X

Nella dashboard clicca su Collega e scegli X. Modiva esegue il flusso OAuth e richiede per te gli scope corretti, poi salva i token di accesso e di refresh in un vault cifrato e li mantiene aggiornati — non maneggi mai le credenziali API grezze di X. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.

Invia un messaggio con messages_send

Chiama `messages_send` con l'ID della connessione, un `recipient_id` e il tuo testo. Modiva lo consegna tramite X e restituisce l'ID del messaggio, rispettando le finestre e le regole di messaggistica di X.

Costruisci una casella di posta o un risponditore IA

Usa `messages_inbox` e `messages_list` per portare le conversazioni in un'unica vista. Tramite MCP un agente può leggere un messaggio in arrivo su X, decidere una risposta e rispondere con `messages_send` — un ciclo di supporto IA completo.

Richiesta di esempio

Chiama lo strumento messages_send tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.

POST /v1/tools/invoke

curl -X POST https://api.modiva.ai/v1/tools/invoke \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "messages_send",
    "connectionId": "conn_…",
    "args": { "recipient_id": "u_456", "text": "Hi! How can we help today?" }
  }'

Provalo con X

Inizia gratis

FAQ

Posso costruire una casella di posta unificata che includa X?

Sì. `messages_inbox` restituisce le conversazioni di X nella stessa forma di qualsiasi altro canale, così un'unica interfaccia di posta le copre tutte.

Modiva rispetta le regole di messaggistica di X?

Sì — Modiva applica le finestre di messaggistica e i vincoli di policy di X, così i tuoi invii restano conformi.

Continua a costruire con X

Integrazione API X Server MCP X Come pubblicare su X tramite API Come pianificare i post su X tramite API Come leggere e rispondere ai commenti su X tramite API Come ottenere le analitiche di X tramite API Come inviare messaggi su Instagram tramite API