Skip to main content
GET
メッセージングプラットフォームのメッセージまたは会話を取得します。 各ソーシャルネットワークによって取得時間が異なります。Facebook、Instagram、および WhatsApp では、メッセージは Ayrshare を介してリアルタイムで利用可能です。X/Twitter では、新しいメッセージの更新を確認するのに最大 3 分の遅延があります。X/Twitter メッセージへのリアルタイムアクセスが必要な場合、Enterprise Plan の詳細についてはサポートまでお問い合わせください。
レスポンスキャッシュ: FacebookInstagramでは、レスポンスは60秒間キャッシュされます。X/Twitterでは、ポーリングをより適切にサポートするためレスポンスは15秒間キャッシュされます。WhatsApp は Meta の webhook 経由ですでに受信済みのメッセージを読み取るため、新しく受信したメッセージは Ayrshare がその webhook を処理し次第すぐに表示されます。レスポンスには引き続き lastUpdated および nextUpdate メタデータが含まれます。
FacebookおよびInstagramの初回メッセージ履歴取得は、最新20件のメッセージに制限されます。詳細については、FacebookおよびInstagramのメッセージ履歴取得セクションをご覧ください。
WhatsApp の会話は、相手の電話番号(数字のみ、先頭の + を含まない E.164 形式)で識別されます。保存されたアウトバウンドメッセージには、sentdeliveredread、または failed のいずれかの status 値が含まれる場合があります。
メッセージ送信を通じて送信された WhatsApp メッセージは、現在 Get Messages の履歴には追加されません。webhook 経由で受信した WhatsApp メッセージはここに保存され、返されます。

ヘッダーパラメータ

パスパラメータ

string
必須
メッセージを取得するプラットフォーム: facebookinstagramtwitterwhatsapp

クエリパラメータ

string
デフォルト:"active"
必須
アクティブな会話またはアーカイブされた会話を返します。値: activeまたはarchived
string
特定の会話のみを返します。
boolean
デフォルト:false
すべての会話を返します。trueの場合、conversationIdフィールドは無視されます。
conversationsOnly=true の場合、会話の詳細は converstationsDetails で返されます。このスペルは現在の API レスポンスの一部です。
integer
X/Twitterのみ。 リクエストあたりに返されるメッセージの数を制限します(1〜100)。完全な履歴同期なしで効率的なポーリングを可能にします。ページネーションにはnextと共に使用します。省略された場合、デフォルトの動作(完全なメッセージ取得)が使用されます。
string
X/Twitterのみ。 前のリクエストのmeta.pagination.nextフィールドから返された暗号化されたページネーションカーソル。次のページの結果を取得するためにlimitと共に使用します。