領収書

SMS APIへのリクエストが成功すると、SMS APIは以下の配列を返す。 message オブジェクトを各メッセージに1つずつ持つ。理想的には status の 0成功したことを示す。しかし、これはメッセージが受信者に届いたことを意味しません。あなたのメッセージが送信のためにキューに入れられたことを意味するだけです。

ヴォネージのアダプティブルーティングそして、あなたのメッセージに最適なキャリアを特定します。選択されたキャリアがメッセージを配信すると、キャリアは 納品書 (DLR）。

アプリケーションでDLRを受け取るには、以下の書類を提出する必要があります。ウェブフックをVonageに送信します。あるいは Reports API を使用して、メッセージごとの配信状況などの記録を定期的にダウンロードすることができます。

注:ほとんどの場合、DLRはメッセージが配送されたことを示す信頼できる指標である。ただし、絶対的な保証ではない。参照領収書の仕組み.

領収書の仕組み

納品書はどちらか：

キャリア - サービスプロバイダがメッセージを受信したときに返される
ハンドセット - ユーザーのハンドセットがメッセージを受信したときに返される

すべての DLR が、ターゲットがメッセージを受信したことを保証するわけではありません。配送レシートの中には、メッセージを別のオペレータに渡すなど、配送プロセスの 1 つの段階だけが正常に完了したことを示すものもある。他の配達受領は偽物です。このため、Vonage は DLR が正確であることを完全に保証することはできません。それは国々あなたがメッセージを送信している相手と、それに関係するプロバイダー。

メッセージが1回のSMSで送信可能な長さより長い場合、メッセージは次のようになります。連結.結合された SMS の各部分について、キャリアの DLR を受信する必要がある。連結されたメッセージに対するハンドセットの DLR は遅延する。これは、ターゲットの携帯端末が完全なメッセージの受信を確認する前に、連結されたメッセージの各部分を処理する必要があるためです。

領収書について

これは典型的なDLRだ：

{
  "err-code": "0",
  "message-timestamp": "2018-10-25 12:10:29",
  "messageId": "0B00000127FDBC63",
  "msisdn": "447547232824",
  "network-code": "23410",
  "price": "0.03330000",
  "scts": "1810251310",
  "status": "delivered",
  "to": "Vonage"
}

最も重要な分野は status そして err-code これらは、あなたのメッセージが届いたかどうか、届かなかった場合は何が悪かったのかを教えてくれる。

DLR ステータスメッセージ

について status フィールドには、SMS が正常に配信されたかどうかが表示されます。可能な値は以下のとおりです：

`status`	説明
`accepted`	メッセージは配信を受け付けましたが、まだ配信されていません。
`delivered`	メッセージが配信されました
`buffered`	メッセージは後で配信するためにバッファリングされている
`expired`	メッセージが下りのキャリアのリトライ方式で保持され、有効時間内に配信できなかった。
`failed`	メッセージが届かない
`rejected`	下りのキャリアがメッセージの配信を拒否
`unknown`	有用な情報なし

DLRエラーコード

について err-code フィールドは、より詳細な情報を提供し、失敗した配送のトラブルシューティングに役立つ。0 以外のコードは、メッセージが配信できなかったことを示す。

`err-code`	意味	説明
0	配信	メッセージは正常に配信されました
1	不明	メッセージが配信されず、理由が特定できなかった。
2	加入者不在 - 一時的	携帯電話が一時的に使用できなかったため、メッセージが配信されませんでした。
3	加入者不在 - 正社員	そのNumbersはもうアクティブではないので、データベースから削除する必要があります。
4	ユーザーによる通話禁止	これは永久的なエラーです。この番号はデータベースから削除され、ユーザーはネットワークオペレータに連絡してバーを削除する必要があります。
5	ポータビリティ・エラー	Numbersのポータビリティに問題があり、それを解決するためにネットワークオペレーターに連絡してください。
6	アンチスパム拒絶	メッセージはキャリアのアンチスパムフィルターによってブロックされています。
7	ハンドセット・ビジー	メッセージの送信時に携帯電話が使用できませんでした。
8	ネットワークエラー	メッセージはネットワークエラーにより失敗しました。
9	不正なNumbers	ユーザーが特定のサービスからのメッセージを受信しないよう特別に要求した場合
10	不正なメッセージ	メッセージのパラメータにエラーがある。
11	ルーティング不能	Vonageはメッセージを配信する適切なルートを見つけることができません。サポート
12	到達不能	その番号へのルートが見つからない-受信者の番号を確認する
13	加入者の年齢制限	ターゲットの年齢により、あなたのメッセージを受信できない。
14	キャリアがブロックしているNumbers	受信者は、自分のプランでSMSを有効にするようキャリアに依頼する必要があります。
15	前払金不足	受信者がプリペイドプランを利用しており、メッセージを受信するのに十分なクレジットがない。
16	ゲートウェイ割り当て超過	期間あたりの許容リクエスト数を超えたため、メッセージ配信に失敗しました。 NBだ：このエラーは、米国とフランスで登録されたアカウントにのみ表示されます。
17	プロバイダーによってブロックされたメッセージ	メッセージングプロバイダがこのメッセージをブロックすることを選択しました。これは、プロバイダが課すコンテンツまたは制限のためである可能性があります。
20	詐欺ディフェンダーの交通ルール	メッセージは不正防御トラフィックルールによって拒否されました。交通ルールの見直しをクリックしてください。詐欺ディフェンダー交通規則の詳細
21	異常な連続ダイヤルが検出された	高密度コンタクト番号範囲のしきい値を超えました。
22	詐欺ディフェンダーSMSバーストプロテクション	トラフィックの制限に達しました
23	AITプロテクション	メッセージはFraud Defender AIT Protectionによって拒否されました。
24	詐欺ディフェンダー・ネットワーク・ルール	メッセージは不正防御ネットワークルールによって拒否されました。ネットワークのルールを見直すをクリックしてください。
25	詐欺ディフェンダー国別ルール	メッセージは不正防御国ルールによって拒否されました。カントリー・ルールの見直しをクリックしてください。
39	米国宛ての不正な送信者アドレス	米国に送信されるすべてのSMSは、Vonageアカウントに関連付けられている米国で事前に承認されたロングナンバーまたはショートコードから発信される必要があります。 US SMSの機能と制限に関する詳細情報
41	1日の上限を超えた	期間中の最大数量に達したため、送信制御がスロットルされた
50	エンティティ・フィルタ	メッセージは次の理由で失敗しました。 `entity-id` 不正確であるか、提供されていない。国別規制の詳細
51	ヘッダーフィルター	ヘッダ ID (`from` 電話番号）が間違っているか、欠落していた。国別規制の詳細
52	コンテンツフィルター	メッセージは次の理由で失敗しました。 `content-id` 不正確であるか、提供されていない。国別規制の詳細
53	同意フィルター	同意が許可されていないため、メッセージは失敗しました。国別規制の詳細
54	レギュレーション・エラー	予期せぬレギュレーションエラー - 連絡先サポート
99	一般的なエラー	リクエストの処理にエラーが発生しました。サポート

DLRの他のフィールドについては、以下のセクションで説明する。 APIリファレンス.

キャンペーンでSMS APIを使用する

メッセージングキャンペーンを始める前に国別特徴ガイドを送信先の国のために使用します。送信先の国が信頼できるDLRを供給していない場合は Conversion API より多くのデータポイントをVonageに提供し、最適なルーティングを保証する。

オプションとして、送信する各メッセージに参照を含めることで、特定の顧客やキャンペーンを特定することができます。これらは配信レシートに含まれます。を指定して、選択した参照をリクエストに渡します。 client-ref パラメータは40文字まで。

その他のリソース

ウェブフックガイド - VonageのプラットフォームでWebhookを使用する方法についての詳細なガイドです。
SMSが届かないのはなぜですか？ - トラブルシューティングのヒント