|Help Centre

Voicemail greetings

Last updated at

In this example, we will learn how to use the API to record a voicemail greeting and how to enable voicemail for a source.

1. Record greeting

To create a new voicemail greeting, POST to the voicemail_greetings resource:

POST /customers/407382/voicemail_greetings
name=MyGreeting
{
 "voicemail_greetings":[{
  "name":"MyGreeting",
  "timestamp":"2012-03-14 20:43:17",
  "datalength":null,
  "locked":"0",
  "used_by":[],
  "customer_id":"407382",
  "vm_greeting_id":"303",
  "sounddata":"",
  "record_number":"+4618123456",
  "record_pin":"8367"
  }]
 }

Now we've created a voicemail greeting placeholder, but we need to record a greeting message. To record a message, dial the number seen in record_number and enter your pin code, record_pin.

2. Enable voicemail

Once recorded, you will need to enable voicemail for a source:

PUT /sources/219982
vm_greeting_id=303&vm_divert_busy=1&vm_divert_noanswer=1&notify_on_new_voicemail=1&email=n@c.com
{
 "sources":[{
  "source_id":"219982",
  "name":"test",
  "email":"n@c.com",
  "smsnumber":null,
  "media":null,
  "customer_id":"407382",
  "phonenr":"+461890510",
  "destnr":"+4618921814",
  "timestamp":"2012-03-13 23:00:00",
  "expire":null,
  "created":"2012-03-14 20:56:46",
  "modified":"2012-03-14 20:58:09",
  "class":"0",
  "status":"active",
  "vm_greeting_id":"303",
  "campaign_id":null,
  "publisher_id":null,
  "notify_on_missed_call":"0",
  "notify_on_new_voicemail":"1",
  "vm_divert_all":"0",
  "vm_divert_busy":"1",
  "vm_divert_noanswer":"1",
  "alt_numbers":[]
  }]
 }

Not only did we enable this source to divert to our previously created voice greeting on busy and no answer, but we also enabled email notifications when someone leaves a new voicemail. Cool, huh?

3. Download greeting

If you want to download your voice greeting, you can GET the voicemail_greetings resource:

GET /customers/407382/voicemail_greetings/303
{
 "voicemail_greetings":[{
  "name":"MyGreeting",
  "timestamp":"2012-03-14 20:51:25",
  "datalength":"24192",
  "locked":"0",
  "used_by":{
   "219982":"test"
  },
  "customer_id":"86931",
  "vm_greeting_id":"303",
  "sounddata":"........"
  }]
 }

Congratulations! You've now learned how to create a voicemail greeting and to assign it to a source using the Freespee API.

Did you find this article helpful?

Gold StarGreen LightYellow LightRed Light
ExcellentGoodAveragePoor

Powered by Customer Thermometer

If you still need help you can ask our Support team