Ringless Voicemail API & SMS Integration

# Use this to send a ringless voicemail drop to a single contact.
# Get your team_id and secret from Settings → API in your Drop Cowboy dashboard.
# Requires a registered brand_id and recording_id (or voice_id + tts_body).
# Delivery status is sent to your configured webhook URL.

curl -X POST https://api.dropcowboy.com/v1/rvm \
  -H "x-team-id: YOUR_TEAM_ID" \
  -H "x-secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "team_id": "YOUR_TEAM_ID",
    "secret": "YOUR_SECRET",
    "foreign_id": "order-12345",
    "brand_id": "YOUR_BRAND_GUID",
    "phone_number": "15551234567",
    "recording_id": "YOUR_RECORDING_GUID",
    "forwarding_number": "15559876543",
    "postal_code": "90210",
    "callback_url": "https://your-domain.com/webhook"
  }'

# Use this to send an SMS text message to a contact.
# Requires a registered pool_id for SMS sending.
# The opt_in field confirms you have consent (required by law).
# Character limit is 160 characters per message.

curl -X POST https://api.dropcowboy.com/v1/sms \
  -H "x-team-id: YOUR_TEAM_ID" \
  -H "x-secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "team_id": "YOUR_TEAM_ID",
    "secret": "YOUR_SECRET",
    "phone_number": "15551234567",
    "caller_id": "15559876543",
    "pool_id": "YOUR_POOL_ID",
    "sms_body": "Hi John! Your appointment is confirmed for tomorrow at 2pm. Reply STOP to opt out.",
    "opt_in": true,
    "foreign_id": "appointment-456",
    "callback_url": "https://your-domain.com/webhook"
  }'

# Use this to retrieve all registered brands in your account.
# You'll need a brand_id to send ringless voicemail.
# Only brands with api_allowed: true can be used via API.

curl -X GET https://api.dropcowboy.com/v1/brand \
  -H "x-team-id: YOUR_TEAM_ID" \
  -H "x-secret: YOUR_SECRET"

# Response includes:
# - brand_id: Use this in your RVM requests
# - company_name: Your registered business name
# - registered: Brand registration status
# - api_allowed: Whether this brand can be used via API

# Use this to organize contacts into lists for campaign targeting.
# Step 1: Create a list, then Step 2: Add contacts to it.
# You can add up to 10,000 contacts per API call.

# Step 1: Create the list
curl -X POST https://api.dropcowboy.com/v1/list \
  -H "x-team-id: YOUR_TEAM_ID" \
  -H "x-secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"list_name": "Q1 Prospects"}'

# Step 2: Add contacts (use list_id from step 1)
curl -X POST https://api.dropcowboy.com/v1/list/YOUR_LIST_ID/contacts \
  -H "x-team-id: YOUR_TEAM_ID" \
  -H "x-secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": ["first_name", "last_name", "phone", "email"],
    "values": [
      ["John", "Doe", "15551234567", "john@example.com"],
      ["Jane", "Smith", "15559876543", "jane@example.com"]
    ],
    "region": "US"
  }'

// Use this to send ringless voicemail using Mimic AI text-to-speech.
// Perfect for dynamic personalized messages without recording audio.
// Requires a voice_id from your Voices tab in Drop Cowboy dashboard.

const axios = require('axios');

async function sendRVMWithAI(contact) {
  const response = await axios.post('https://api.dropcowboy.com/v1/rvm', {
    team_id: process.env.DROP_COWBOY_TEAM_ID,
    secret: process.env.DROP_COWBOY_SECRET,
    foreign_id: `contact-${contact.id}`,
    brand_id: process.env.BRAND_ID,
    phone_number: contact.phone,
    voice_id: process.env.VOICE_ID, // Your Mimic AI voice
    tts_body: `Hi ${contact.firstName}, this is Sarah from Acme Corp. 
               I wanted to follow up on your recent inquiry about our services. 
               Please call me back at 555-987-6543. Thanks!`,
    forwarding_number: '15559876543',
    postal_code: contact.zip
  }, {
    headers: {
      'x-team-id': process.env.DROP_COWBOY_TEAM_ID,
      'x-secret': process.env.DROP_COWBOY_SECRET,
      'Content-Type': 'application/json'
    }
  });
  
  console.log('RVM queued:', response.data);
  return response.data;
}

// Example usage
sendRVMWithAI({
  id: 12345,
  firstName: 'John',
  phone: '15551234567',
  zip: '90210'
});

// Use this to receive delivery status updates from Drop Cowboy.
// Configure your webhook URL in Settings → API in your dashboard.
// Drop Cowboy sends callbacks for: delivered, failed, opted_out events.

const express = require('express');
const app = express();

app.post('/webhooks/dropcowboy', express.json(), async (req, res) => {
  // Webhook payload includes:
  // - foreign_id: Your reference ID from the original request
  // - status: 'delivered', 'failed', or 'opted_out'
  // - phone_number: Recipient's phone number
  // - reason: Error details (if failed)
  
  const { foreign_id, status, phone_number, reason } = req.body;
  
  console.log(`Drop Cowboy callback: ${foreign_id} - ${status}`);
  
  // Update your database
  await db.campaigns.update({
    where: { id: foreign_id },
    data: { 
      status: status,
      delivered_at: status === 'delivered' ? new Date() : null,
      error_reason: reason
    }
  });
  
  // Always respond with 200 OK
  res.status(200).send('OK');
});

app.listen(3000, () => {
  console.log('Webhook server running on port 3000');
});