IOSOR Learn

Second inbound number: inbox handover without mixed threads

Manage inbox assignment and keyword routing when a second DID starts receiving mobile originated traffic without mixing conversation threads.

Second inbound number: inbox handover without mixed threads.

Architecture of multi-DID inbound queues

When a tenant activates a second number, inbound mobile originated payloads start hitting the routing gateway simultaneously. Treating all incoming traffic as a single stream breaks customer context. Each digital identifier must map strictly to dedicated agent queues or automated workflows. If your account maintains a USD 20 prepaid floor, number allocation happens instantly through programmatic API calls rather than manual provisioning queues.

JIT provisioning and prepaid state checks

Numbers are never held in offline physical stock; they are requested just-in-time via API integration. When provisioning a secondary line, the control plane validates the tenant balance against the USD 20 prepaid floor before binding the resource. Once attached, mobile originated payloads begin dispatching immediately. Operators must track payload consumption alongside Inbound MO billing versus outbound MT mechanics to separate inbound acquisition costs from outbound termination fees.

Keyword mapping and thread segregation

To prevent mixed conversation threads, incoming text bodies must be parsed for primary routing keywords before reaching the inbox interface. A payload containing 'START' on DID A routes to onboarding, while the exact same keyword on DID B routes to a separate promotional campaign. This programmatic isolation ensures agents never reply to the wrong context. When throughput scales and monthly traffic approaches a soft review near USD 1,000/month, strict webhook concurrency tuning prevents dropped messages during peak campaign windows.

Ingest resilience and retry logic

Network disruptions between the telecommunications gateway and downstream message consumers can lead to dropped packets or duplicate deliveries. Implementing solid consumption patterns requires adherence to inbound webhook retries to guarantee exactly-once processing. Every incoming mobile originated event carries a unique identifier that consuming systems must store temporarily to filter out duplicate network transmissions safely.

Monitoring consumer performance at scale

High-volume inbound environments demand strict observability across all webhook consumer nodes to detect processing bottlenecks early. Tracking consumer lag, HTTP 5xx error rates, and queue depth prevents silent delivery failures. Detailed operational guidelines for scaling ingestion layers are outlined in Webhook consumer ops at volume. Maintaining clean logs ensures rapid root-cause analysis when routing rules fail or agents report delayed message rendering.

Start with IOSOR

In staging, assign a second inbound number to the same tenant. Send MO A to the first DID and MO B to the second. Threads must stay split: no shared inbox row, no keyword-map bleed, no agent seeing both as one conversation. Export the two inbox keys and the handover checklist. Merging threads because it is the same customer fails this job. This is a second-number inbox handover, not a JIT first-cutover of a new assign.

IOSOR takeaway

A second inbound number is a second inbox. Handover fails if threads mix.

Do: route and store by DID, then hand the new inbox to ops with a split map. Don't: fold the second number into the first thread or treat assign as the whole handover.

Was this guide helpful?

Related guides