ログイン無料トライアルを開始
easyCoexistence 公式 API

お客様が Instagram をアプリに接続する方法

お使いのバックエンドが easyCoexistence の POST /connect-sessions を channel instagram で呼び出し、返された url へお客様を案内します。お客様は Business または Creator アカウントで Instagram Login からサインインします。その後 channel_id 付きで redirect_url に戻り、GET /channels/{id}?credentials=1 で graph.instagram.com 用のトークンが返されるため、アプリから投稿の公開、コメントの読み取り、DM への返信ができます。

100 posts

Instagram アカウントが API から直近 24 時間に公開できる投稿数です。カルーセルは 1 件と数えます。

JPEG

Meta が API 経由の Instagram 投稿でサポートする唯一の画像形式です。

24 hours

ほとんどのユーザー操作で、人から届いた Instagram DM に返信できる標準の期間です。相手が先に書き込む必要があります。

1 private reply

コメントへのプライベートリプライで、アカウントが相手に送れるメッセージの数です。コメントから 7 日以内に限られます。

1 hour

セッションの期限が切れるまで、easyCoexistence の接続リンクが有効な時間です。

お客様は接続のために何をしますか?

ボタンを 1 つ押すだけです。アプリは channel を instagram に設定し、redirect_url と、お客様の ID を external_ref としてセッションを作成して、返された url へお客様を案内します。ホスト型のページにはアプリ名と「Continue with Instagram」が表示され、同じタブで Instagram 自身のログイン画面が開くため、スマートフォンでも利用できます。お客様がアクセスを承認すると、status=connected と channel_id 付きで redirect_url に戻ります。バックエンドは 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

どの Instagram アカウントを接続できますか?

Meta の Instagram API が対象とするプロアカウント、つまり Business または Creator アカウントです。easyCoexistence を使う別のサービスで既に接続されているアカウントは拒否され、セッションの last_error にその旨が表示されます。その場合、お客様はそのサービスで先に接続を解除するか、別のアカウントでサインインします。DM を扱う場合は、アカウントで「Allow access to messages in the Instagram app」も有効にする必要があり、その手順は Instagram 接続ガイドに記載されています。

アプリはどのトークンを受け取りますか?

graph.instagram.com/v25.0 用の Instagram ユーザートークンです。Instagram の ID である account_id_on_meta は GET /channels/{id}?credentials=1 から取得します。easyCoexistence は 60 日の期限が切れる前に十分な余裕をもってトークンを更新します。更新すると新しいトークンが発行されるため、1 件のコピーを保持し続けず、ジョブを開始するたびに認証情報を取得してください。

アプリはアカウントへどのように投稿しますか?

POST /channels/{id}/posts を使います。ig_type は IMAGE、CAROUSEL、REELS、STORIES から選択します。省略すると、メディアに応じて自動的に判定されます。複数のファイルはカルーセルに、1 本の動画はリールになります。ここでのカルーセルは 2 件から 10 件までで、画像は JPEG である必要があります。テキストは 2,200 文字まで使えますが、Instagram の投稿にはリンク用のフィールドがありません。publish_at を指定しない場合はすぐに公開され、指定するとその時刻に公開されます。指定できるのは 90 日先までです。

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

コメントと DM はアプリにどう届きますか?

送信先を設定すると届きます。PUT /channels/{id}/webhook に URL を指定すると、そのアカウントの署名用シークレットが返されます。以降、コメント、メンション、DM は届き次第転送され、X-EC-Signature で署名されます。ボディには platform、account_id、external_id と、Meta の Webhook entry がそのまま含まれます。コメントとメンションは changes に、DM は messaging に入ります。

アプリはコメントや DM にどう返信しますか?

Meta の Instagram API(graph.instagram.com)を、お客様のトークンを使って呼び出します。そのため、返信はすべてお客様のアカウントから送信されます。

  • コメントへの返信:POST /<IG_COMMENT_ID>/replies に message を指定します。
  • DM への返信:POST /<IG_ID>/messages で、recipient に相手の ID、message に本文を指定します。相手の最後のメッセージから 24 時間以内に限ります。
  • コメントへのプライベートリプライ:同じ messages エッジを使い、recipient に comment_id を指定します。コメントごとに 1 回、コメントから 7 日以内に限ります。
  • コメントの非表示または削除:/<IG_COMMENT_ID> に対して POST または DELETE を送ります。

お客様のアクセスが終了した場合はどうなりますか?

Instagram がトークンを拒否した場合、または所有者が Instagram の設定でアクセスを取り消した場合、イベント URL に channel.disconnected が届きます。そのお客様で新しい接続セッションを作成すると、アカウントが再び接続されます。アプリ側から接続を終了するには DELETE /channels/{id} を使います。これによりネットワーク側のアクセスが取り消され、キューに残っている投稿はキャンセルされます。課金は請求サイクルの終わりで停止します。

よくある間違い

  • PNG または WebP の画像を Instagram に送信すること。Meta は JPEG のみ公開を受け付けるため、キューに入る前に投稿が拒否されます。先に画像を変換してください。
  • Instagram の投稿にリンク用のフィールドを付けること。Instagram の投稿にはリンクを付けられないため、リクエストが拒否されます。URL は本文に入れてください。
  • 24 時間より古い DM に返信ボタンを表示すること。Meta が返信を許可するのは、相手の最後のメッセージが開いた期間内に限られます。
  • 同じコメントに 2 回目のプライベートリプライを送ること。Meta は 1 回のみ許可しており、相手が返信するまで後続の送信は待機します。
EasyCoexistence で実現する

easyCoexistence を使うと、お客様はホスト型のサインインを 1 回行うだけで Instagram をアプリに接続できます。バックエンドは更新されたトークン、投稿用エンドポイント、そしてコメントと DM を Webhook で受け取れるようになり、すべての接続は 24 時間 365 日監視されます。同じ呼び出しで WhatsApp、Facebook、TikTok、YouTube、LinkedIn などのほかのチャネルにも対応します。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料トライアルです。

よくある質問

お客様の Instagram アカウントを接続するには、自分の Meta アプリが必要ですか?

いいえ。お客様は easyCoexistence のアプリでサインインし、お使いのバックエンドは credentials 呼び出しを通じて、Meta の Instagram API 用のトークンを受け取ります。

お客様は複数の Instagram アカウントを接続できますか?

はい。サインインごとに 1 件ずつ接続できます。同じ external_ref でアカウントごとに接続セッションを作成してください。GET /channels?external_ref= で、そのお客様のアカウントをすべて一覧できます。

アプリで Instagram ストーリーズを予約投稿できますか?

はい。ig_type を STORIES に設定し、画像または動画 1 件と publish_at の時刻を指定すると、キューがその時刻に公開します。

Instagram アカウント 1 件あたりの料金はいくらですか?

接続済みアカウント 1 件ごとに、接続総数の料金帯に応じて月額 US$ 9 から US$ 0.75 までです。最初の 3 日間は無料トライアルです。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日