Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

MSG91

Schemesmsg91://
Cargo featureservice-msg91
Servicehttps://msg91.com
Body formatstext (first is the default)
Attachmentsno
Title lengthno title (merged into the body)
Body length160 characters
Body linesunlimited
Request throttlenone
Vendor URLs acceptedno

URL formats

{schema}://{template}@{authkey}/{targets}

{schema} is one of msg91://.

URL tokens

TokenMeaningTypeRequiredDefaultNotes
{authkey}Authentication Keystringyessecret; must match ^[a-z0-9]+$
{target_phone}Target Phone Nostringnoprefix +; must match ^[0-9\s)(+-]+$
{targets}Targetslistyesany of target_phone; separated by /
{template}Template IDstringyessecret; must match ^[a-z0-9 _-]+$

Query parameters

ParameterMeaningTypeDefaultNotes
short_urlShort URLboolno
toTargetslistsets {targets}

Prefixed parameters:

  • :name=value: Template Mapping

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaaaaa/15551232000
msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaaaaa/15551232000?:body=body
msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaaaaa/15551232000/15551232001?short_url=yes
msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaaaaa/?to=15551232000&short_url=no
msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaaaaa/15551232000?:body=msg&:type=&:extra=value&:mobiles=x

Rejected URLs:

msg91://
msg91://-
msg91://aaaaaaaaaaaaaaaaaaaaaaa
msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaa-x/15551232000

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'msg91://tttttttttttttttttttt@aaaaaaaaaaaaaaaaaaaaaaa/15551232000'

Notes

MSG91 flows (msg91://): SMS through MSG91 flow templates.