SpokenBuzz

You can now access our voice messaging service from our free API. Currently, we have one service available that allows you to make a request to initiate a phone call to any number and allow the recipient of the phone call to record a short voice message. We return the URL of a web-page that you can link to play back the message. You may use this link in any way that you want to enhance your service or build mashups.
Join the SpokenBuzz API Discussion | Call-in with your comments

You can also use the returned buzzID to create an embeddable Javascript snippet that will play the recorded message inside any web-page. Just drop the following code into any spot on your web-page to create an embedded player that will play the recorded message.

There are 2 ways to access recorded messages:

  • Embedded Javascript
    < SCRIPT type="text/javascript" src="http://spokenbuzz.com/cgi-bin/playmsg.cgi?buzzid=buzzID" > < /SCRIPT>
  • Web page - displays an entire threaded conversation starting. This uses the embedded Javascript calls from above.
    http://www.spokenbuzz.com/cgi-bin/buzzforum.cgi?buzz=buzzID

    REST Specification

    endpoint:
    http://spokenbuzz.com/cgi-bin/recordMsg.cgi
    parameters:
    number - specify a complete (U.S. only for now) telephone number here, including coutry and area-code
    parentid - buzzID of the parent message. Set to 0 for starting new topics. Use this to create a discussion thread.
    secret - set to a value if parentid is 0. This will be required to edit/moderate a discussion under a new topic. New topics are those messages that have parentid set to 0.
    replyok - set to N if you do not want the listener of a message to create a reply to it. Setting to N will disallow the creation of a discussion thread.
    txtmsg - You can use this field to store some text along with the recorded message. This can be used as a topic name for new discussions.

    Return XML:
    < msgURL> URL of web-page that plays back the recorded message or thread of messages < /msgURL>
    < buzzID> Permanent Identifier for the message < /buzzID>
    < Error> text of any error messages < /Error>

    Example call:

    http://spokenbuzz.com/cgi-bin/recordMsg.cgi?number=17145551212&txtmsg=My%20New%20Discussion&replyok=Y
    This call will initiate a phone call to 1-714-555-1212 within a few seconds. The person called will be asked to record a message. Immediately after the call is completed, the URL in the returned XML will become active. Using the returned URL, you can create a link, embed it into an email or anything else that you can think up.

    This could return the following XML:
    < msgURL>http://spokenbuzz.com/cgi-bin/buzzforum.cgi?buzz=0a0616565214741 < /msgURL>
    < buzzID> 0a0616565214741 < /buzzID>