/**
* Sends a message to the specified addresses.
*
* @param array $addresses strings that holds the addresses to which
* the specified messages will be sent.
* @param string|null $text text body of message or null if none
* @param string|null $subject subject of message or null if none
* @param array|null $fnames file names of attachments or null if none
* @param bool|null $isGroup whether to send as broadcast or null to
* use default
*
* @return string message id
* @throws ServiceException if API request was not successful
*/
public function sendMessage($addresses, $text, $subject, $fnames = null, $isGroup = null)
{
$endpoint = $this->getFqdn() . '/myMessages/v2/messages';
$req = new RESTFulRequest($endpoint);
$req->setHeader('Accept', 'application/json')->setHeader('Content-Type', 'application/json')->setAuthorizationHeader($this->getToken());
$vals = array('addresses' => $addresses);
$vals['isGroup'] = $isGroup ? 'true' : 'false';
if ($text !== null) {
$vals['text'] = $text;
}
if ($subject !== null) {
$vals['subject'] = $subject;
}
$messageRequest = array('messageRequest' => $vals);
$jvals = json_encode($messageRequest);
$result = null;
if ($fnames == null) {
// no attachments; send basic POST
$req->setHeader('Content-Type', 'application/json');
$httpPost = new HttpPost();
$httpPost->setBody($jvals);
$result = $req->sendHttpPost($httpPost);
} else {
// attachments; send as multipart
$mpart = new HttpMultipart();
$mpart->addJSONPart($jvals);
foreach ($fnames as $fname) {
$mpart->addFilePart($fname);
}
$result = $req->sendHttpMultipart($mpart);
}
$responseArr = Service::parseJson($result);
return $responseArr['id'];
}
/**
* Sends a custom API request for converting speech to text.
*
* @param string $cntxt speech context.
* @param string $fname path to file that contains speech to convert.
* @param string $gfname path to file that contains grammar.
* @param string $dfname path to file that contains dictionary.
* @param string $xArg optional arguments.
* @param string $lang language used to set the Content-Language header.
*
* @return array API response as an array of key-value pairs.
* @throws ServiceException if API request was not successful.
*/
public function speechToTextCustom($cntxt, $fname, $gfname = null, $dfname = null, $xArg = null, $lang = 'en-US')
{
$endpoint = $this->getFqdn() . '/speech/v3/speechToTextCustom';
$mpart = new SpeechMultipartBody();
$req = new RESTFulRequest($endpoint);
$req->setHeader('X-SpeechContext', $cntxt)->setHeader('Accept', 'application/json')->setHeader('Content-Language', $lang)->setAuthorizationHeader($this->getToken());
if ($xArg != null) {
$req->setHeader('X-Arg', $xArg);
}
if ($dfname != null) {
$mpart->addXDictionaryPart($dfname);
}
if ($gfname != null) {
$mpart->addXGrammarPart($gfname);
}
$mpart->addFilePart($fname);
$result = $req->sendHttpMultipart($mpart);
return Service::parseJson($result);
}
