Nvoip
Voice & TelephonyUse the Nvoip Brazilian VoIP and SMS provider for outbound calls, SMS, voice blasts, one-time passcodes, virtual numbers, and sub-accounts. Agents reach Brazilian customers on the channel each situation calls for.
What This Integration Enables
Nvoip is a Brazilian provider, and this connector does not smooth that away, because the specifics are what make it useful. Destinations are given in Brazilian national format, area code plus number with no country code. SMS is capped at 160 characters and rejects accented characters, which is a genuine constraint when the message is in Portuguese and the words you want carry accents. Balance is a prepaid figure in reais that every call, message, and blast draws down. Nvoip publishes no webhooks, so following a call means polling Get Call on roughly a two second cycle, exactly as the vendor prescribes. If you are reaching Brazilian customers, these are the facts of the channel, and a flow that respects them works while one written for a generic global gateway does not.
What Nvoip gives an agent is a choice of how to reach someone and a first-class way to prove who they are. Send One Time Password will deliver the same code by SMS, by a voice call that reads it aloud, by email, or by any combination, which matters for customers who do not read texts or whose handset is not receiving them. Send Two Factor Code covers the same ground for authentication flows with its own token and verification step. Send Voice Blast plays audio or text-to-speech to a destination and captures a DTMF keypress, turning a broadcast into a survey. Around all of that sit sub-accounts and virtual numbers, so a flow can provision a SIP extension for a new hire and repoint an inbound number without anyone opening the panel.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Verification That Escalates Channel Instead of Repeating Itself
A signup enters a mobile number. The agent calls Send One Time Password over SMS, keeps the returned key, and waits. If Check One Time Password reports a match, the account opens. If it comes back not found, which Nvoip returns for both an expired code and one already validated, the agent treats it as a failed verification and does something more useful than sending the same thing again: it reissues the code as a voice call that reads the digits aloud. A number that cannot receive SMS very often answers the phone. Only when that also fails does the flow stop and hand the case to a person.
Click-to-Call from the Pipeline with the Recording Attached
A rep clicks call on a record. The agent places the call with Make Call from the rep's SIP extension to the customer's number in national format, then polls Get Call on the cycle Nvoip prescribes, following the call through ringing, answer, and hangup. Because talking duration only starts counting once the destination answers, the agent can tell a real conversation apart from thirty seconds of ringing. When the call finishes, Get Call returns the recording link, and the agent writes the duration, outcome, and recording onto the customer record before the rep has finished typing their note.
Interactive Voice Survey with a Balance Guard
A support team wants a one-question satisfaction survey after a service visit. The agent builds a Send Voice Blast with a spoken question and a DTMF capture, sets the timeout to the sum of the audio lengths plus the keypress wait with headroom, and dials the day's completed visits. Keypresses come back in the response, so a rating lands on the job record without a follow-up email. Before the run starts, the agent reads Get Balance and converts the string Nvoip returns into a number, because a blast that exhausts the account mid-run leaves half the customers surveyed and the other half not.
Human-in-Loop Highlight
Every Nvoip send costs money and draws down a prepaid balance, and the verification actions are the ones most likely to be called in a loop. That combination has a specific failure mode: a signup flow that keeps reissuing codes to a number that never verifies. Sometimes that is a customer with a bad handset. Sometimes it is a number chosen precisely because sending to it generates traffic somebody else profits from. Either way, the third automatic Send One Time Password is money leaving the account with no verification coming back, and the pattern reads identically from inside the flow.
So a FlowRunner signup agent handles the first failure by itself, switching channel from SMS to a voice call, and then pulls the digital andon cord. It posts the case to the risk owner with everything needed to rule on it: "Signup 88421, number 11 9xxxx 5590, two codes issued (SMS then voice), neither verified. 4 other signups today used numbers in the same range. Account balance R$ 214. Issue a third code, hold the signup for manual review, or block the range?" The agent does not guess at fraud and it does not keep spending. It stops the line and puts the judgment where it belongs. Building human-in-the-loop into a verification path costs one message and one pause, and it is the difference between a retry policy and a policy.
Agent Capabilities
19 actionsCalls
4- Make Call Places a real, billable outbound call. The caller is a SIP user or internal extension on the account and the destination uses Brazilian national format, area code followed by the number with no country code. Every run dials a live number and consumes balance, so it belongs behind explicit conditions. Returns the call ID used by Get Call and End Call.
- Get Call Retrieves the current state, recording link, and duration of a call by ID. Nvoip prescribes polling this on roughly a two second cycle to follow a call through ringing, answer, and hangup, and the record stays readable for a few seconds after the call ends. Talking duration starts only once the destination answers, so ringing time is excluded.
- End Call Immediately terminates a call in progress, cutting off a live conversation. Nvoip responds with a finished state and the link to the recording up to that point.
- Send Voice Blast Places a real, billable voice broadcast that plays one or more audios to the destination, supplied either as a public MP3 URL or as text read aloud. Adding a DTMF capture turns it into an interactive menu whose pressed digits return in the response. Set the timeout to the sum of every audio length plus the keypress wait, with headroom.
Messaging
1- Send SMS Sends a real, billable one-way text message, so recipient replies are not returned. Two hard limits apply: no accented characters, and at most 160 characters. Sending as a flash message shows the text on the recipient's screen without storing it in the inbox. Copy for this channel needs writing to the constraint, not trimming afterwards.
Verification
4- Send Two Factor Code Sends a two factor authentication code to a user by email, by SMS to their mobile, or to both at once. At least one destination is required. Keep the returned token, because Verify Two Factor Code needs it alongside the digits the user types in.
- Verify Two Factor Code Checks the code a user entered against the issued token. Nvoip distinguishes a successful validation from a code already used and from one that has expired, so a flow should branch on the returned status rather than treating every non-success as a wrong code.
- Send One Time Password Sends a one time password by SMS, by a voice call that reads the code aloud, by email, or by any combination. At least one destination is required, and voice and SMS delivery are billable. Keep the returned key for Check One Time Password. The multi-channel option is what makes a channel switch possible instead of a blind resend.
- Check One Time Password Validates the password a user entered against the issued key. A code that has already been validated or has expired comes back as not found rather than as a plain mismatch, so both should be treated as a failed verification.
Account
3- Check Token Introspects an access token and reports whether it is active, when it expires, which account it belongs to, and what scopes it carries. Useful for diagnosing authentication problems; leaving the token empty introspects the one the connection is currently using.
- Get Balance Retrieves the remaining credit on the account. Nvoip returns the balance as a string rather than a number, so a flow converts it before comparing against a threshold. Best used as a guard step before a bulk SMS or voice campaign.
- Get Tariffs Retrieves the call tariffs linked to the account. Nvoip documents only an empty response for this endpoint, so accounts without published tariffs return an empty list with an explanatory note rather than an error.
Secondary Users
5- List Secondary Users Retrieves every secondary user attached to the primary account with their name, email, numbersip extension, and a masked password. Only primary accounts may call this, and Nvoip publishes no pagination, so the whole list returns at once.
- Get Secondary User Retrieves one secondary user by numbersip extension, returning whether the webphone is enabled, whether the account is blocked, the caller ID in use, and the SIP password. Note that Nvoip switches this record to Portuguese field names where the list uses English.
- Create Secondary User Adds a secondary user to the primary account and returns the generated numbersip extension. Only primary accounts may call this, and an email address already registered is rejected. Used as the telephony step of a new hire flow.
- Update Secondary User Changes a secondary user's display name, SIP password, blocked state, or webphone access. Blocking a user immediately stops them placing and receiving calls, which makes this the fastest lever in an offboarding flow.
- Delete Secondary User Permanently removes a secondary user from the primary account. The extension stops working immediately and the action cannot be undone, so a flow confirms the extension before running it unattended.
Virtual Numbers
2- List Virtual Numbers Retrieves the account's virtual numbers with their city and state, monthly payment, activation fee, per-minute cost, simultaneous call capacity, and where inbound calls currently route. No pagination is published, so the full inventory returns at once.
- Update Virtual Number Repoints a virtual number at a new destination, changing where its inbound calls land as soon as it is saved. The destination may be an account user, an external number, an IP address or domain running your own PBX, or a follow-me chain. This takes effect on the next inbound call, so it is worth confirming the destination before saving.
Frequently Asked Questions
What can FlowRunner do with Nvoip?
FlowRunner agents can run Make Call, Get Call, and End Call in Nvoip, plus 16 more actions.
Does connecting Nvoip to FlowRunner require OAuth?
No. Nvoip connects to FlowRunner with an API key, no OAuth flow required.
Can Nvoip trigger a FlowRunner workflow automatically?
Nvoip doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Nvoip
$100 in credits. No card required. Connect in minutes.