InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Hoe je je klanten Instagram met je app laat verbinden

Je backend roept POST /connect-sessions van easyCoexistence aan met channel instagram en stuurt de klant naar de geretourneerde url, waar die inlogt met Instagram Login op een Business- of Creator-account. Daarna keert de klant terug naar je redirect_url met een channel_id, en GET /channels/{id}?credentials=1 geeft een token voor graph.instagram.com, zodat je app posts kan publiceren, reacties kan lezen en op DM's kan reageren.

100 posts

Via de API gepubliceerde posts die een Instagram-account in een lopend tijdvak van 24 uur kan plaatsen; een carrousel telt als één.

JPEG

Het enige afbeeldingsformaat dat Meta ondersteunt voor publiceren op Instagram via de API.

24 hours

Standaardperiode om te reageren op een DM op Instagram, voor de meeste gebruikersacties; die persoon moet eerst schrijven.

1 private reply

Berichten die een account via een privé-reactie naar iemand die heeft gereageerd kan sturen, binnen 7 dagen na de reactie.

1 hour

Hoe lang een easyCoexistence-verbindingslink werkt voordat de sessie verloopt.

Wat moet de klant doen om te verbinden?

Klik op één knop. Je app maakt de sessie aan met channel ingesteld op instagram, een redirect_url en het id van je klant als external_ref, en stuurt de klant daarna naar de url ervan. De gehoste pagina toont je naam en Doorgaan met Instagram, wat de eigen inlog van Instagram in hetzelfde tabblad opent, dus het werkt ook op telefoons. De klant keurt de toegang goed en komt terecht op je redirect_url met status=connected en de channel_id, die je backend bevestigt met 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

Welke Instagram-accounts kunnen verbinden?

Professionele accounts, Business of Creator, die de Instagram API van Meta bedient. Een account dat al via een andere dienst die easyCoexistence gebruikt is verbonden, wordt geweigerd, en de last_error van de sessie vermeldt dat; de klant verwijdert het daar eerst of logt in met een ander account. Voor DM's zet de klant ook Toegang tot berichten toestaan aan in de Instagram-app, en de Instagram-verbindingsgids geeft het pad.

Welk token krijgt je app?

Een Instagram-gebruikerstoken voor graph.instagram.com/v25.0, met account_id_on_meta, het Instagram-id van het account, uit GET /channels/{id}?credentials=1. easyCoexistence vernieuwt het ruim voordat de 60 dagen verstrijken, en vernieuwen geeft een nieuw token uit, dus haal de inloggegevens aan het begin van elke taak op in plaats van één kopie te bewaren.

Hoe publiceert je app naar het account?

Met POST /channels/{id}/posts. ig_type kiest IMAGE, CAROUSEL, REELS of STORIES, en wordt afgeleid van de media als je het weglaat: meerdere bestanden maken een carrousel en één video maakt een Reel. Een carrousel bevat hier 2 tot 10 items, afbeeldingen moeten JPEG zijn, de tekst mag tot 2.200 tekens lang zijn en een Instagram-post heeft geen linkveld. Zonder publish_at gaat hij nu uit; met publish_at op dat tijdstip, tot 90 dagen vooruit.

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" }
    ]
  }'

Hoe komen reacties en DM's bij je app?

Zodra je een bestemming instelt. PUT /channels/{id}/webhook met je URL geeft het ondertekeningsgeheim van dat account terug, en vanaf dat moment worden de reacties, vermeldingen en DM's doorgestuurd zodra ze binnenkomen, ondertekend met X-EC-Signature. De body bevat platform, account_id, external_id en de webhook-entry van Meta ongewijzigd, met changes voor reacties en vermeldingen en messaging voor DM's.

Hoe reageert je app op reacties en DM's?

Via de Instagram API van Meta op graph.instagram.com, met het token van de klant, zodat elke reactie van het account van de klant komt:

  • Op een reactie reageren: POST /<IG_COMMENT_ID>/replies met een bericht.
  • Op een DM reageren: POST /<IG_ID>/messages met recipient ingesteld op het id van de persoon en de berichttekst, binnen 24 uur na het laatste bericht van die persoon.
  • Privé reageren op een reactie: dezelfde messages-edge met recipient comment_id, één keer per reactie, binnen 7 dagen na de reactie.
  • Een reactie verbergen of verwijderen: POST of DELETE op /<IG_COMMENT_ID>.

Wat gebeurt er als de toegang van de klant eindigt?

Je events-URL ontvangt channel.disconnected wanneer Instagram het token weigert of de eigenaar de toegang intrekt in de instellingen van Instagram. Een nieuwe verbindingssessie voor die klant brengt het account terug. Om het van jouw kant te beëindigen trekt DELETE /channels/{id} de toegang in op het netwerk en annuleert de posts die nog in de wachtrij staan, en de facturering stopt aan het einde van de cyclus.

Veelgemaakte fouten

  • PNG- of WebP-afbeeldingen naar Instagram sturen. Meta publiceert alleen JPEG, dus de post wordt geweigerd voordat hij in de wachtrij komt; converteer afbeeldingen eerst.
  • Een linkveld op een Instagram-post zetten. Instagram-posts hebben geen link, dus het verzoek wordt geweigerd; zet de URL in de tekst.
  • Een Antwoord-knop tonen bij DM's die ouder zijn dan 24 uur. Meta staat reacties toe binnen het venster dat het laatste bericht van de persoon opende.
  • Een tweede privé-reactie op dezelfde reactie sturen. Meta staat er één toe; een vervolgbericht wacht tot de persoon antwoordt.
Dit doen met EasyCoexistence

easyCoexistence laat je klanten Instagram met je app verbinden via één gehoste inlog, en geeft je backend daarna een vernieuwd token, een posts-endpoint en hun reacties en DM's via webhook, waarbij elke verbinding 24/7 wordt bewaakt. Dezelfde aanroepen dekken WhatsApp, Facebook, TikTok, YouTube, LinkedIn en meer kanalen. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.

Veelgestelde vragen

Heb ik mijn eigen Meta-app nodig om Instagram-accounts van klanten te verbinden?

Nee. Klanten loggen in via de app van easyCoexistence, en je backend ontvangt het token voor de Instagram API van Meta via de credentials-aanroep.

Kan een klant meerdere Instagram-accounts verbinden?

Ja, één per inlog. Maak voor elk account een verbindingssessie aan met dezelfde external_ref, en GET /channels?external_ref= geeft ze allemaal voor die klant.

Kan mijn app Instagram-Stories plannen?

Ja. Zet ig_type op STORIES met één afbeelding of video en een publish_at-tijdstip, en de wachtrij publiceert hem dan.

Wat kost easyCoexistence per Instagram-account?

Elk verbonden account kost US$ 9 tot US$ 0,75 per maand, volgens de schaal van je totaal aantal verbindingen, met de eerste 3 dagen gratis.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op