IOSOR

IOSOR База знань

Inbound-події та inbox на орендованих номерах: двосторонній ops без хаосу webhook

Як B2B-команди приймають SMS і voice на орендованих номерах, будують inbox UX і обробляють retry/idempotency.

Outbound отримує слайди; inbound — пейджер. Коли клієнт відповідає STOP, надсилає фото або передзвонює на орендований номер, платформа має доставити події у ваші системи — з inbox, якому вірить support. Двосторонній продукт без inbound-дисципліни — одностороннє обіцяння з чергою скарг.

IOSOR призначає орендовані номери з inbound webhook і client-safe помилками — без чужого порталу для day-two ops, чесний white-label каталог. Біля USD 1 000+ місячного platform usage докази webhook auth, логи STOP і correlation ID inbox стають матеріалом комерційного review. Спочатку evidence, потім scale.

Типи подій, які треба спланувати

Подія Поверхня продукту Потрібно ops
Вхідний SMS Thread / ticket Deduped webhook + зберігання
Delivery receipts Timeline статусу Correlation до вихідної відправки
Voice callbacks Черга / голосова пошта Політика запису + згода
Keyword STOP/HELP Compliance-лог Негайний suppression

Inbound — не «все, що прийшло». У кожного класу події є product surface і ops-потреба. Пропуск STOP — compliance-інцидент; пропуск DLR correlation — сліпа пляма фінансів. Див. гід двостороннього inbox і політика ключових слів STOP і HELP.

Дисципліна webhook для inbound

  • Автентифікуйте вхідні запити
  • Idempotent handlers — retries нормальні
  • Persist до side effects (CRM, auto-replies)
  • Dead-letter queue з replay

Retries будуть. Дублі тикетів із неавтентифікованих, неідемпотентних consumer — типовий провал. Порівняйте повторні спроби вхідного вебхука. Збережіть подію до CRM і auto-reply, інакше replay дасть другий тикет і друге повідомлення клієнту. Каталог live без webhook auth — обіцянка, яку не можна захистити.

Inbox UX без дірок для фроду

Inbox — не іграшка-чат, а evidence:

  1. Номер, timestamp і тіло з безпечною редакцією.
  2. Зв’язок із outbound-контекстом, якщо відповідь у thread.
  3. Rate-limit auto-replies проти циклів.
  4. Audit-експорт для compliance-питань.

Агенти не повинні бачити сирі upstream payload. White-label помилки лишаються usable; секрети й діагностика лишаються в ops. Auto-reply без consent-контексту стає циклом, який палить prepaid і злить отримувача.

Життєвий цикл орендованого номера й inbox

Номери renew за UTC calendar-month; release має чисто зупиняти inbound events. Задокументуйте owners для renew vs retire — фінанси не мають дізнатися про смерть номера від злих клієнтів. Паралельно: реальність оренди local і toll-free. Рядок inbox без живого assignment — привид; live-номер без власника inbox — немоніторений inbound-канал. Каталог in setup — не двосторонній production.

Червоні прапорці

  • Inbound «coming soon» на production-номерах
  • Немає dedupe → дублі тикетів
  • Auto-replies без consent-контексту
  • Неможливо trace, який номер отримав подію
  • Upstream payload сирцем агентам
  • Webhook без підпису при каталозі live
  • Release номера, який усе ще доставляє inbound

Старт з IOSOR

Призначте один орендований двосторонній номер. Надішліть тестовий MO. Відкрийте inbox і підтвердіть один рядок з DID, тенантом і correlation id. Програйте ту саму подію з dead-letter і переконайтеся, що другого рядка немає. Дайте support шлях STOP, який вони прочитають вголос. Це артефакт inbox на орендованому DID, не блокування шлюзу і не дросель потопу.

Підсумок IOSOR

Inbox на орендованому номері — рядок для support. Webhook 2xx без рядка — тихий дроп.

Робіть: прив’яжіть кожен MO до рядка, який агент відкриє. Не робіть: лишати inbound у сирому логу і називати це inbox.

Чи був матеріал корисним?

Пов’язані гіди