Send RVM Using the SDK

Sends a ringless voicemail to a phone number using the Drop Cowboy SDK

⚠️ Important: RVM Compliance & Sending Guidelines

All Ringless Voicemail (RVM) activity through Drop Cowboy must follow federal and state regulations, including the TCPA and Telemarketing Sales Rule (TSR).

Key compliance requirements:

• Obtain explicit consent from all recipients

• Provide a clear opt-out mechanism

• Use only approved number pools and audio recordings

Note: Drop Cowboy's API supports 1-to-1 RVM sends only — bulk or campaign-style submissions are not supported.

---

Sending Limits & Delivery Behavior

• Soft limit: 10,000 requests per second

  • Keep concurrent requests under 100 for best performance

• Scaling: If you plan to exceed 1,000 requests/sec, contact your Drop Cowboy account manager or support

• Contact frequency:

  • Default: 3 attempts in 3 days (TCPA)

  • FDCPA-regulated users: up to 7 attempts in 7 days (configurable)

• Delivery timing:

  • Most RVMs deliver within 5 minutes

  • Messages queued outside 8am–9pm local TCPA hours are automatically held until the next valid window

• Call forwarding: Avoid forwarding to toll-free numbers — some carriers block these connections, reducing callback success rates

---

Compliance Support

Drop Cowboy provides built-in tools and account-level configuration options to help you:

• Enforce contact attempt limits

• Manage local time compliance

• Track consent and opt-out requests

For advanced configurations or higher send volumes, contact Drop Cowboy Support or your account manager.

sendRvm(payload: { phone_number: string; brand_id: string; recording_id: string; callback_url: string; })

---

Returns: Promise<object> — API response with a status (status value should be "queued").

Example:

// Download the helper library from https://www.npmjs.com/package/dropcowboy
const { DropCowboy } = require("dropcowboy"); // Or, for ESM: import { DropCowboy } from "dropcowboy";

// Find your Team ID and Secret at dropcowboy.com/appv1/#/api
// and set the environment variables.
const teamId = process.env.DROPCOWBOY_TEAM_ID;
const secret = process.env.DROPCOWBOY_SECRET;
const client = new DropCowboy({ teamId: teamId, secret: secret });

async function sendRinglessVoicemail() {
      const rvm = await client.sendRvm({
            brand_id: "00000000-0000-0000-0000-000000000000", 
            recording_id: "00000000-0000-0000-0000-000000000000", 
            phone_number: "[phone]", 
            forwarding_number: "[phone]", 
            foreign_id: "YOUR_DATABASE_RECORD_ID", 
            callback_url: "https://your.server.com"
      });

      console.log(rvm.status); // "queued"
};

sendRinglessVoicemail();

---

Parameters:

Name	Type	Required	Description
team_id	string	yes	Located on the API Setting tab. Example: <Your Team ID>
secret	string	yes	Located on the API Setting tab. Example: <Your Team Secret>
brand_id	string	yes	Located in your account's trust center tab.
phone_number	string	yes	Your contact's phone number in E.164 format. Example: [phone]
audio_url	string	conditional	A URL to the voicemail audio (mp3 or wav). Requires special approval. Example: https://example.com/yourfile.mp3
audio_type	string	conditional	File type of audio_url (mp3 or wav). Example: mp3
forwarding_number	string	conditional	Phone number to forward calls/texts when contact replies. Example: [phone]
recording_id	string	conditional	ID of the audio recording.
voice_id	string	conditional	ID of the Mimic AI™ voice to use.
tts_body	string	conditional	Text to convert to speech using voice_id. Example: Hey Joe, this is Bob from Brand...
status_format	string	conditional	Status code mapping for callbacks. Only set if instructed by Drop Cowboy
byoc	object	conditional	SIP Trunks and STIR/SHAKEN credentials. Contact support for details
foreign_id	string	optional	Value to identify this drop in your system. Example: <Your system's ID>
privacy	string	optional	Caller ID privacy settings. Example: off
phone_ivr_id	string	optional	IVR to use when contact calls back.
pool_id	string	optional	ID of private number pool. Defaults to public shared pool
postal_code	string	optional	Contact postal code for TCPA compliance. Example: 02101
callback_url	string	optional	Override default RVM webhook URL. Example: http://example.com