AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come permettere ai tuoi clienti di collegare Instagram alla tua app

Il tuo backend chiama POST /connect-sessions di easyCoexistence con channel instagram e invia il cliente all'url restituito, dove accede con Instagram Login su un account Business o Creator. Torna al tuo redirect_url con un channel_id, e GET /channels/{id}?credentials=1 restituisce un token per graph.instagram.com, così la tua app può pubblicare, leggere i commenti e rispondere ai DM.

100 posts

Post pubblicati tramite l'API che un account Instagram può fare in 24 ore mobili; un carosello conta come uno.

JPEG

L'unico formato immagine che Meta supporta per pubblicare su Instagram tramite l'API.

24 hours

Finestra standard per rispondere a un DM Instagram di una persona, per la maggior parte delle azioni utente; la persona deve scrivere per prima.

1 private reply

Messaggi che un account può inviare a chi ha commentato tramite risposta privata, entro 7 giorni dal commento.

1 hour

Durata di validità del link di connessione easyCoexistence prima che la sessione scada.

Cosa deve fare il cliente per collegarsi?

Preme un pulsante. La tua app crea la sessione con channel impostato su instagram, un redirect_url e l'id del cliente come external_ref, poi invia il cliente al suo url. La pagina ospitata mostra il tuo nome e Continua con Instagram, che apre il login di Instagram nella stessa scheda, quindi funziona anche da telefono. Il cliente approva l'accesso e arriva al tuo redirect_url con status=connected e il channel_id, che il tuo backend conferma con GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_id

Quali account Instagram possono collegarsi?

Gli account professionali, Business o Creator, che è ciò che serve l'API Instagram di Meta. Un account già collegato tramite un altro servizio che usa easyCoexistence viene rifiutato e last_error della sessione lo indica; il cliente lo rimuove lì prima oppure accede con un altro. Per i DM, l'account deve anche attivare Consenti l'accesso ai messaggi nell'app Instagram, e la guida alla connessione Instagram ne indica il percorso.

Quale token riceve la tua app?

Un token utente Instagram per graph.instagram.com/v25.0, con account_id_on_meta, l'ID Instagram dell'account, da GET /channels/{id}?credentials=1. easyCoexistence lo rinnova ben prima che scadano i suoi 60 giorni, e il rinnovo emette un nuovo token, quindi recupera le credenziali all'inizio di ogni operazione invece di conservarne una copia.

Come pubblica la tua app sull'account?

Con POST /channels/{id}/posts. ig_type sceglie IMAGE, CAROUSEL, REELS o STORIES, e viene dedotto dal media se lo ometti: più file formano un carosello e un video diventa un Reel. In questo caso un carosello accetta da 2 a 10 elementi, le immagini devono essere JPEG, il testo arriva fino a 2.200 caratteri e un post Instagram non ha un campo link. Senza publish_at va online subito; con publish_at, all'orario indicato, fino a 90 giorni in anticipo.

A carousel on the customer's Instagram account
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ig_post_2291" \
  -d '{
    "text": "Three looks for the weekend.",
    "ig_type": "CAROUSEL",
    "media": [
      { "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
    ]
  }'

Come arrivano commenti e DM alla tua app?

Una volta impostata una destinazione. PUT /channels/{id}/webhook con il tuo URL restituisce il segreto di firma di quell'account, e da quel momento i suoi commenti, le menzioni e i DM vengono inoltrati man mano che arrivano, firmati con X-EC-Signature. Il corpo della richiesta contiene platform, account_id, external_id e la voce webhook di Meta invariata, con changes per commenti e menzioni e messaging per i DM.

Come risponde la tua app a commenti e DM?

Tramite l'API Instagram di Meta su graph.instagram.com, con il token del cliente, così ogni risposta arriva dall'account del cliente:

  • Rispondere a un commento: POST /<IG_COMMENT_ID>/replies con un message.
  • Rispondere a un DM: POST /<IG_ID>/messages con recipient impostato sull'ID della persona e il testo del messaggio, entro 24 ore dall'ultimo messaggio della persona.
  • Risposta privata a un commento: lo stesso endpoint messages con recipient comment_id, una volta per commento, entro 7 giorni da esso.
  • Nascondere o eliminare un commento: POST o DELETE su /<IG_COMMENT_ID>.

Cosa succede quando l'accesso del cliente termina?

Il tuo URL degli eventi riceve channel.disconnected quando Instagram rifiuta il token o il titolare revoca l'accesso dalle impostazioni di Instagram. Una nuova sessione di connessione per quel cliente riporta l'account. Per chiuderlo dal tuo lato, DELETE /channels/{id} revoca l'accesso presso la rete e annulla i post ancora in coda, e la fatturazione si interrompe alla fine del ciclo.

Errori comuni

  • Inviare a Instagram immagini PNG o WebP. Meta pubblica solo JPEG, quindi il post viene rifiutato prima di entrare in coda; converti prima le immagini.
  • Inserire un campo link in un post Instagram. I post Instagram non hanno link, quindi la richiesta viene rifiutata; inserisci l'URL nel testo.
  • Mostrare un pulsante Rispondi sui DM più vecchi di 24 ore. Meta consente le risposte entro la finestra aperta dall'ultimo messaggio della persona.
  • Inviare una seconda risposta privata allo stesso commento. Meta ne consente una; un seguito attende che la persona risponda.
Farlo con EasyCoexistence

easyCoexistence permette ai tuoi clienti di collegare Instagram alla tua app con un unico accesso ospitato, poi fornisce al tuo backend un token rinnovato, un endpoint per i post e i loro commenti e DM tramite webhook, con ogni connessione monitorata 24/7. Le stesse chiamate coprono WhatsApp, Facebook, TikTok, YouTube, LinkedIn e altri canali in arrivo. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.

Domande frequenti

Serve una mia app Meta per collegare gli account Instagram dei clienti?

No. I clienti accedono tramite l'app di easyCoexistence, e il tuo backend riceve il token per l'API Instagram di Meta con la chiamata credentials.

Un cliente può collegare più account Instagram?

Sì, uno per accesso. Crea una sessione di connessione per ciascun account con lo stesso external_ref, e GET /channels?external_ref= li elenca tutti per quel cliente.

La mia app può programmare le Instagram Stories?

Sì. Imposta ig_type su STORIES con una immagine o un video e un orario publish_at, e la coda la pubblica a quell'ora.

Quanto costa easyCoexistence per account Instagram?

Ogni account collegato costa da US$ 9 a US$ 0,75 al mese, in base alla fascia del totale delle tue connessioni, con i primi 3 giorni di prova gratuita.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il