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

SaaS を Ayrshare、Zernio、Unipile から easyCoexistence へ移行:コードで変わる点

Ayrshare、Zernio、Unipile から easyCoexistence へ移行すると、コードの 4 つの部分が変わります。連携はアカウントごとのホスト型接続セッションになります。宛先の指定は、external_ref と組み合わせた channel_id または connection_id で行います。投稿はアカウントごとに POST /channels/:id/posts を 1 回呼び出します。イベントはアカウントごとに署名されるか、Meta から直接お使いのサーバーへ送られます。各お客様は、ネットワーク独自の同意画面から、もう一度サインインする必要があります。

Profile-Key

Ayrshare のリクエストを User Profile に送るヘッダー(Profile-Key)。Authorization には Primary Profile の API キーを指定します。

5 minutes

generateJWT が生成する Ayrshare 連携 URL の既定の有効期間。最大 2,880 分にするには Max Pack が必要です。

8 statuses

Zernio の投稿ステータス:draft、pending_approval、scheduled、publishing、published、partial、failed、cancelled。

X-API-KEY

Unipile API が受け取るヘッダー。ベース URL はお使いの DSN で、ホスト型の認証リンクなどの呼び出しに使います。

1 hour

easyCoexistence の接続リンクの有効期間。1 つのリンクは、1 つの番号または 1 回のソーシャルサインインで完了します。

何がどれに対応しますか?

考え方はそのまま引き継がれますが、形式は変わります。お客様、アカウントを接続するリンク、アカウントを指定する ID、投稿の呼び出し、イベントには、それぞれ対応するものがあります。以下の対応表は、各プロバイダーの公式ドキュメント(2026 年 11 月 3 日時点で確認)と、easyCoexistence の Partner API リファレンスに基づいています。

Ayrshare, Zernio or UnipileeasyCoexistence
Your customerAn Ayrshare User Profile, a Zernio profile or the name on a Unipile linkexternal_ref on each connect session, connection and event
LinkinggenerateJWT, GET /v1/connect/{platform} or POST /api/v1/hosted/accounts/linkPOST /connect-sessions, one account per link
AddressingProfile-Key, profileId with accountId, or account_idchannel_id for a social account, connection_id for a number
AuthenticationA Bearer key, with Profile-Key on Ayrshare; X-API-KEY on UnipileAuthorization: Bearer ec_live_…
PostingOne request with a list of platforms, on Ayrshare and ZernioPOST /channels/:id/posts, one per account
Incoming eventsThe provider's webhooksSigned forwards per account; WhatsApp from Meta to your URL

Ayrshare から移行すると何が変わりますか?

プロファイルの層がなくなります。Ayrshare では、Profile-Key ヘッダーを使って User Profile に投稿を送り、POST /api/post の platforms リストで各ネットワークへ展開します。scheduleDate は UTC、ファイルは mediaUrls で指定します。easyCoexistence では、お客様のチャンネルごとにループを回します。各チャンネルで POST /channels/:id/posts を 1 回呼び出し、publish_at は任意のオフセット付き、メディアは {url, type} の形で指定します。連携は、generateJWT(既定で 5 分間有効な URL)から、アカウントごとに 1 時間有効な接続セッションへ移ります。

Node.js: one post per channel instead of a platforms list
const EC = "https://easycoexistence.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.EC_API_KEY}` };

// Before: POST https://api.ayrshare.com/api/post with Profile-Key,
// { post, platforms: ["instagram", "facebook"], mediaUrls, scheduleDate }
async function schedule(customerId, post) {
  const { data } = await fetch(`${EC}/channels?external_ref=${customerId}`, { headers: auth })
    .then((r) => r.json());
  for (const ch of data.filter((c) => post.networks.includes(c.channel) && c.status === "connected")) {
    await fetch(`${EC}/channels/${ch.id}/posts`, {
      method: "POST",
      headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": `${post.id}-${ch.id}` },
      body: JSON.stringify({
        text: post.text,
        media: post.mediaUrls.map((url) => ({ url, type: post.type })),
        publish_at: post.scheduleDate, // ISO 8601 with Z or an offset
      }),
    });
  }
}

Zernio から移行すると何が変わりますか?

投稿の部分は、他社からの移行より変更が少なくなります。Zernio の POST /v1/posts は、content、platform と accountId から成る platforms リスト、mediaItems、タイムゾーン付きの scheduledFor を受け取り、easyCoexistence と同じく Idempotency-Key に対応しています。platforms リストは、channel_id ごとの 1 回の呼び出しになります。scheduledFor はオフセット付きの publish_at になります。Zernio の draft と pending_approval のステータスに対応するものはないため、下書きと承認は自社のプロダクト側で管理します。連携は、profileId を指定して authUrl を返す GET /v1/connect/{platform} から、url を返し、リダイレクト先で channel_id を受け取る POST /connect-sessions へ移ります。

Unipile から移行すると何が変わりますか?

主にメッセージングの部分です。Unipile では、お使いの DSN に対して X-API-KEY を付けて POST /api/v1/hosted/accounts/link でアカウントを連携し、POST /api/v1/chats/{chat_id}/messages で送信します。アカウント自身が送信したメッセージも含め、新着メッセージは message_received の Webhook で通知されます。easyCoexistence では、WhatsApp の番号は Coexistence を通じて Meta の Cloud API に参加します。これには WhatsApp Business アプリが必要です。Meta は、そのメッセージをお使いの webhook_url に配信します。返信は、お客様のトークンを使い、番号の send_endpoint へ送ります。Instagram の DM は、チャンネルの認証情報を使って Meta の API を経由します。

お客様は再接続が必要ですか?

はい、アカウントごとに 1 回です。各お客様が付与したアクセス権は、それを要求したプロバイダーのアプリに属するため、別のアプリへ移すことはできません。各アカウントは、ホスト型の接続リンクから、ネットワーク独自の同意画面で再度サインインします。WhatsApp の番号の場合は、Meta のポップアップを使います。お客様がすぐに対応できるときに依頼してください。各リンクの有効期間は 1 時間で、1 つのアカウントは未使用のリンクを 50 件まで持て、1 時間あたり 100 件まで作成できます。

ダウンタイムなしで切り替えるには?

アカウントごとに、各お客様が移行を終えるまで両方のプロバイダーを並行稼働させます。コードは、各アカウントをそれを保持しているプロバイダーへ振り分けます。channel.connected または connection.connected を受け取った時点が、そのアカウントを切り替えるタイミングです:

  • お客様の ID を external_ref にマッピングし、channel_id と connection_id が届いたら、その横に保存します。
  • 投稿や受信が多いアカウントを優先して、お客様ごとに接続リンクを送ります。
  • channel.connected を受け取ったら、そのアカウントの保留中の投稿を easyCoexistence で予約し、旧プロバイダー側ではそれらをキャンセルします。
  • そのアカウントのイベントを新しい受信エンドポイントに向けてから、旧プロバイダーで連携を解除します。

コードで変わらない部分は?

自社のプロダクトです。作成画面、カレンダー、承認フロー、受信箱はそのまま残り、その下にあるアダプターだけが変わります。メディアは引き続き公開 HTTPS リンクで指定し、冪等性はヘッダーで担保します。イベントの検証は、生のボディに対する HMAC で行います。ラップされた呼び出しを超える処理が必要な場合は、GET /channels/:id?credentials=1 で得た認証情報を使い、ネットワーク独自の API へ直接送ります。

よくある間違い

  • アカウントの再接続前に、旧プロバイダーで投稿をキャンセルすること。channel.connected が届くまで、easyCoexistence では何も投稿できません。先に再予約し、後からキャンセルしてください。
  • WhatsApp をコンシューマー向けアプリで使っているお客様を移行すること。Coexistence が対象とするのは WhatsApp Business アプリの番号なので、接続リンクを開く前に、お客様が番号を WhatsApp Business アプリへ移す必要があります。
  • お客様のすべてのネットワークに対して 1 つのリンクを送ること。リンクは 1 つの番号または 1 回のサインインで完了するため、アカウントごとに 1 つずつ接続セッションを作成してください。
  • cancelled をそのまま同じ綴りで扱うこと。easyCoexistence は canceled(l が 1 つ)で報告するため、コード内のステータス比較をすべて更新してください。
EasyCoexistence で実現する

easyCoexistence は、お客様の WhatsApp の番号と、Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントに、ホスト型の接続リンク、新しい認証情報、投稿キュー、署名付きイベントを提供します。さらに多くのチャンネルにも対応していきます。各ネットワークの公式 API を通じて、すべての接続を 24 時間 365 日監視します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど US$ 0.75 まで下がります。最初の 3 日間は無料トライアルです。

よくある質問

移行後も、お客様の連携済みアカウントをもう一度サインインさせずに移行できますか?

いいえ。各ネットワークはアクセス権を、それを要求したアプリに紐付けるため、すべてのアカウントは easyCoexistence の接続リンクから 1 回サインインする必要があります。

easyCoexistence は、X、Threads、Telegram に対応していますか?

現時点では対応していません。対応が終わるまで、それらのアカウントは現在のプロバイダーに残してください。新しいネットワークは、追加されるたびに同じ Partner API に、接続 1 件あたり同じ料金で加わります。

Unipile で行っている LinkedIn のメッセージは続けられますか?

Unipile に残してください。easyCoexistence は、LinkedIn のページとプロフィールに対して投稿とコメントで動作し、LinkedIn の DM は提供していません。

移行後、easyCoexistence の料金はいくらになりますか?

接続 1 件あたり月額 US$ 9 から、接続を増やすほど US$ 0.75 まで下がります。全ネットワークで同額で、最初の 3 日間は無料トライアルです。

続きを読む

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

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

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

確認日