お客様が 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 への返信ができます。
Instagram アカウントが API から直近 24 時間に公開できる投稿数です。カルーセルは 1 件と数えます。
Meta が API 経由の Instagram 投稿でサポートする唯一の画像形式です。
ほとんどのユーザー操作で、人から届いた Instagram DM に返信できる標準の期間です。相手が先に書き込む必要があります。
コメントへのプライベートリプライで、アカウントが相手に送れるメッセージの数です。コメントから 7 日以内に限られます。
セッションの期限が切れるまで、easyCoexistence の接続リンクが有効な時間です。
お客様は接続のために何をしますか?
ボタンを 1 つ押すだけです。アプリは channel を instagram に設定し、redirect_url と、お客様の ID を external_ref としてセッションを作成して、返された url へお客様を案内します。ホスト型のページにはアプリ名と「Continue with Instagram」が表示され、同じタブで Instagram 自身のログイン画面が開くため、スマートフォンでも利用できます。お客様がアクセスを承認すると、status=connected と channel_id 付きで redirect_url に戻ります。バックエンドは GET /connect-sessions/{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 日先までです。
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 を使うと、お客様はホスト型のサインインを 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 監視
確認日