Shortcodes & inbound
Receive texts. Keywords on a shared shortcode or a dedicated code of your own turn SMS into a two-way channel — and every inbound message can hit your webhook in real time.
The pieces
- Shortcode — the number people text (e.g. 40770). Rent a keyword on our shared code or run a dedicated one.
- Keyword — the first word routes the message:
JOINgoes one place,INFOanother, each with its own auto-reply and webhook. - Webhook — inbound messages POST to your endpoint as they arrive; the payload contract is on the webhooks page.
Setting up — all over the API
- Apply for a dedicated shortcode, or skip straight to the shared platform code.
- Reserve a keyword and configure its auto-reply and callback URL.
- Point your webhook receiver at the documented payload — or poll the inbound API.
- Optionally attach a survey so the keyword runs a structured Q&A instead.
Opt-in and STOP
A keyword text is a documented opt-in; STOP replies land the number on your blacklist automatically and every future send skips it. Your webhook still receives the STOP message so your own system can mirror the state.
Replying
Auto-replies are configured per keyword. For dynamic replies, respond from your system with a normal send call using your shortcode as the senderID — inbound and outbound stitch into one conversation for the subscriber.