API Tutorial
Come pubblicare su WhatsApp tramite API
Per pubblicare su WhatsApp tramite API, collega l'account WhatsApp con Modiva (che gestisce OAuth e scope) e poi chiama lo strumento `posts_create` con il tuo testo e i tuoi media — Modiva lo pubblica su WhatsApp e restituisce l'ID del post.
L'API di WhatsApp richiede la revisione dell'app, la gestione di OAuth e i permessi di pubblicazione corretti prima ancora di poter pubblicare un solo aggiornamento. Modiva si occupa di tutto questo per te e mette a disposizione un unico strumento `posts_create` che pubblica su WhatsApp (e su ogni altra piattaforma collegata) nello stesso modo.
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 WhatsApp
Nella dashboard clicca su Collega e scegli WhatsApp. 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 WhatsApp. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.
Chiama posts_create per pubblicare su WhatsApp
Chiama lo strumento `posts_create` con l'ID della connessione e il tuo contenuto. Modiva verifica il payload rispetto alle regole di formato di WhatsApp (lunghezza, tipi di media, proporzioni) e pubblica immediatamente, restituendo l'ID e l'URL del post live.
Fai di più — pianifica, cross-posta, automatizza
La stessa chiamata alimenta un agente IA tramite MCP: indirizza Claude o Cursor su `https://mcp.modiva.ai/v1` e potrà pubblicare su WhatsApp per tuo conto. Sostituisci `posts_create` con `posts_schedule` per metterlo in coda, oppure `posts_cross_post` per diffondere un post su ogni piattaforma in una volta sola.
Richiesta di esempio
Chiama lo strumento posts_create tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Provalo con WhatsApp
Inizia gratisFAQ
Ho bisogno di un'app per sviluppatori WhatsApp per pubblicare tramite API?
No. Modiva possiede l'app WhatsApp già approvata e gestisce OAuth, così ti colleghi con un clic e parti subito — nessuna revisione dell'app, nessuna complicazione con gli scope.
Un agente IA può pubblicare su WhatsApp per me?
Sì. Lo stesso strumento `posts_create` è esposto tramite il Model Context Protocol, così qualsiasi client MCP (Claude, Cursor e simili) può pubblicare su WhatsApp non appena aggiungi la tua chiave MCP di Modiva.