ガイド

実際の仕組み

メッセージングで細部を誤りやすいポイント:セグメントとは何か、レート制限は実際どこにあるのか、なぜ「受け付け済み」が「配送済み」を意味しないのか。聞こえの良い説明ではなく、プラットフォームの実際の動作に基づいて書いています。

4 分

ご自身のアカウントを持ち込む

プラットフォームは自前のプロバイダーアカウントを持ちません。この設計判断ひとつで、番号の所有者も、割り当ての保持者も、請求書に載る名前も変わります。

ガイドを読む →
5 分

SMS セグメントと、実際に支払う対象

SMS はメッセージ単位ではなくセグメント単位で課金されます。テキストが一つのセグメントに収まるかは、必要な文字セットと接続に設定したエンコーディングで決まります。

ガイドを読む →
7 分

オプトアウト処理

オプトアウトは二つの半分から成ります。抑制レコードと、プロモーションメッセージをプロバイダーへ渡す前のチェックです。両方が共通の正規化を通るので、そこがたいてい壊れる箇所になります。

ガイドを読む →
5 分

配送レシートの読み方

レシートは判定ではなく、状態の連なりです。途中の状態を最終と扱うことが、送信ダッシュボードが嘘をつく最も多い原因です。

ガイドを読む →
5 分

ペース、割り当て、そしてキューにする理由

各接続には送信レートが設定されています。プラットフォームはプロバイダーが受け付ける限界まで一気に送らず、そのレートに合わせてキューに入れます。スロットルされる最短の道は、まさにそれを引き起こす速度で送ることだからです。

ガイドを読む →
4 分

ルーティングとフェイルオーバー

ルートは優先度で並び、接続内で重み付けされます。狙いは、プロバイダーが拒否しても送信が遅くなるだけで、止まらないようにすることです。

ガイドを読む →
4 分

メッセージがプロモーションかを決めるのは誰か

プラットフォームは本文から推測せず、送信するメッセージ種別の申告を求めます。この一つのフィールドがオプトアウトゲートの適用を決めます。申告の正確さはお客様側の責任です。

ガイドを読む →
4 分

タイムアウトは失敗ではない

送信は非同期で受け付けられ、重複排除キーはありません。不安だからとリクエストを再送すると、二通目が送られてその分が課金されます。

ガイドを読む →
4 分

似ていて似ていない、二つのエンドポイント

配送レシートと着信返信は別のエンドポイントで、プロバイダーのコンソール内でも別の場所で設定します。レシート URL だけを設定すると、オプトアウト処理はどこにもエラーを出さないまま、静かに止まります。

ガイドを読む →
3 分

番号を取り戻す

オプトアウトした受信者は再オプトインできます。プラットフォームは抑制レコードを削除せず無効化するので、同意の履歴が残ります。

ガイドを読む →
4 分

コールバックが落ちているときに起きること

最終結果はお客様が管理する URL へ、回数を抑えたリトライ付きでプッシュされます。ハンドラは重複を許容する必要があり、全メッセージ分の呼び出しを期待してはいけません。

ガイドを読む →
3 分

いま触れたのはどちらのレート制限か

送信の手前には二つのスロットルがあります。プランが決めるものと、ネットワークエッジのかなり高いものです。どちらも同じステータスコードを返すため、見分ける手がかりはメッセージ本文です。

ガイドを読む →
3 分

受信者に実際に見えているのは誰か

送信者を指定しなければ、そのメッセージを運ぶ接続からプラットフォームが一つ選びます。明示的に指定した場合は、どこでもそちらが優先されます。

ガイドを読む →
3 分

プラットフォームが保持しないもの

メッセージ本文はアーカイブされません。残るのはメタデータで、その中の二つのフィールドが要になります。これがないと請求書と突き合わせられないからです。

ガイドを読む →
対象範囲。 これらのガイドは、初回接続から本番運用まで SMS チャネルを順に解説します。メールと WhatsApp も同じ接続モデルです —— プロバイダーを選び、自社アカウントを紐付け、コンソールから送信します。