Flow
Create reusable OTP verification flows that define how codes are generated, which channel sends them, and which channels take over if the first one fails.
Verification Flow
A Verification Flow is a saved OTP configuration. You set up the OTP settings (code length, expiry, channel, sender, message) once in the dashboard, and every verification that uses the flow follows them.
Each flow defines:
OTP rules: code type, code length, expiry, and resend limits.
Primary channel: SMS, Voice, or WhatsApp, with its sender and message.
Fallback sequence (optional): up to two more channels, tried in the order you set.
You can create as many flows as you need, for example one for sign-up, one for login, and one for payment confirmation.
Go to Verify → Flow in the D7 dashboard to manage your flows.
Before you start
SMS
At least one registered SMS originator (sender ID). If you have none, contact us to register one.
A WhatsApp Business number onboarded under WhatsApp → Getting Started, and at least one approved Authentication template for that number.
Voice
No onboarding needed. To place a Test Call from the flow editor, your account's mobile number must be verified (Account → Preferences).
The Flow list
The Flow page lists all your flows with these columns:
Name
The display name you gave the flow.
Flow Id
The flow's unique identifier.
Channel
The primary channel (SMS, VOICE, or WHATSAPP).
OTP Type
The code type: numeric, alpha, or alphanumeric.
Use the search box to find a flow by name or Flow ID. Each row has three actions:
Edit: opens the flow in the editor.
Delete: removes the flow after you confirm.
Analytics: opens the flow's analytics page.
Create a flow
Click Create Flow. The editor has three steps. General settings
General Identity
Flow Name
A name to recognise the flow, for example User Signup Flow. Up to 150 characters.
Flow ID
The flow's unique identifier, used by your developers to send OTPs through this flow. It's filled in automatically from the name (for example user_signup_flow), and you can change it. Only lowercase letters, numbers, and underscores are allowed. Up to 150 characters.
The Flow ID must be unique in your account, and it can't be changed after the flow is created.
OTP Complexity
Alpha
a–z
abcdef
Numeric
0–9
123456
Alphanumeric
a–z and 0–9
a1b2c3
Timing & Limits
Expiry Duration
How long the OTP stays valid after it's sent.
30–18000 seconds
300
Max Retry Count
Maximum number of times the OTP can be resent to the same number.
1–10
5
Retry Delay
Minimum wait before the OTP can be resent.
30–600 seconds
60
OTP Code Length
Number of characters in the code.
2–10
6
Click Next : Channels. Primary channel
Under Select Preferred Channel, choose the channel used to send the OTP first. A Live Preview on the right shows how the message will look, using a sample code that matches your OTP settings.
SMS
Originator: the sender name shown on the user's phone.
Message Content: the SMS text. Use
{}where the OTP should appear, for exampleYour OTP Code is {}.
Voice
Voice Language: the language of the automated call.
Gender: shown when the selected language has more than one voice.
Voice Content: the text read out on the call. Use
{}where the OTP should be spoken, for exampleYour verification code is {}. I repeat, your verification code is {}.Test Call: places a real call to a number you enter, so you can hear the message before saving.
Originator: your onboarded WhatsApp Business number.
WhatsApp Message Template: an approved Authentication template for that number. Select the originator first to load its templates.
Click Next : Fallback Logic.
Fallback logic (optional)
Fallback channels give the OTP another way to reach the user if the primary channel doesn't succeed. You can add up to two fallback channels. Only channels other than the primary one are listed:
Global SMS: Text-only fallback that works on all devices.
WhatsApp Business: High deliverability.
Voice Call: automated text-to-speech call.
To set up the Fallback Sequence:
Select the checkbox on a channel card to add it. A number badge shows its position in the sequence (1 is tried first).
Click a card to show its settings under Configuration Details, and fill them in. The fields are the same as in step 2 (for Voice, the language field is labelled TTS Language).
If you add two fallback channels, use Swap Fallback Priority to change their order.
If you start editing a channel's settings, it's added to the sequence automatically. Clear its checkbox to remove it.
Voice is billed as an add-on. When a flow combines Voice with SMS or WhatsApp (as primary or fallback), an extra Voice charge applies on top of your SMS/WhatsApp Verify price whenever Voice is used to send the OTP.
Click Create Flow to save. If a selected fallback channel is missing required details, the editor opens that channel's settings and highlights what's missing.



Click Edit on the flow list, or Edit Flow on the flow's analytics page. The same three-step editor opens with the current settings filled in. Click Save Changes on the last step.
You can change everything except the Flow ID.
Delete a flow
Click Delete on the flow list, or Delete on the flow's analytics page, and confirm.
Last updated