Skip to content

Glossary

Term Meaning
API key A credential for your servers, sent as X-Api-Key. sf_live_ keys send real SMS; sf_test_ keys use the sandbox. See Authentication.
Audience The contacts a campaign sends to: everyone in its groups or with its tags, minus opted-out and blacklisted numbers.
Audit log The record of security and configuration actions in your organization.
Blacklist Numbers that never receive a message from your organization. A STOP reply adds the sender.
Blocked A final message status: the message was never sent because of the blacklist, an opt-out or a canceled campaign.
Campaign A paced bulk send of one message, personalised per contact. See Run a campaign.
Consent The record of where and when a contact agreed to receive messages.
Contact A person you send campaigns to, one per phone number.
Contact group A static list of contacts.
Cooldown The pause a phone keeps between two messages, plus a random jitter, to protect the SIM.
Cursor The opaque nextCursor value that fetches the next page of a list.
Default SIM The SIM used when a message names no phone, SIM or pool.
Delivery report The handset’s confirmation that turns a message from sent to delivered. Not every network sends one.
Device An Android phone paired to your organization that sends and receives SMS.
E.164 The international number format: +, country code and number, with no spaces, such as +201001234567.
Encoding How a text is packed into SMS: GSM7 (160 characters a segment) or UCS2 (70 characters a segment, needed for Arabic).
Event Something that happened, delivered to your webhook, such as message.delivered. Each has an evt_ id.
Failover Moving a message to another phone in its pool when the first phone doesn’t take it.
Gateway The SMSFabric Android app running on a phone, sending and receiving for your organization.
Idempotency key A value you send with a create request so a retry never creates twice. See Idempotency.
iOS companion The iPhone app. It shows your account and can send with a tap, but cannot send silently or read SMS.
Metadata Your own JSON attached to a message and returned in every webhook about it.
Opt-out A contact’s request not to receive campaigns, by a STOP reply or set by you.
Organization Your account: it owns every phone, message, contact and key. Members join it with a role.
Pairing Linking a phone to your organization by scanning a QR code from the portal.
Pool A group of phones that share traffic round robin, with failover.
Problem An error response in RFC 9457 format, with a stable code.
Quiet hours Hours in the recipient’s local time when a campaign doesn’t send.
Role A member’s set of permissions: owner, admin, developer, campaign_manager, agent, viewer or billing.
Sandbox The virtual phone behind sf_test_ keys. Messages are processed and reported, but never sent. See Sandbox.
Scope A permission an API key carries, such as messages:send.
Segment One SMS part. Long texts are split into segments and joined again on the recipient’s phone.
Send window Daily hours outside which live messages wait. Set in preferences.
Signing secret The whsec_ secret used to verify webhook signatures. Shown once.
SMS pumping Fraud that triggers SMS to expensive number ranges. Verify blocks it.
Template A saved message body with variables such as {{first_name}}.
Verification One one-time code sent with Verify, and its status.
Verify SMSFabric’s one-time code (OTP) service. See Verify phone numbers.
Webhook An HTTPS endpoint of yours that receives signed events. See Webhooks.