API Properties
HTTPS only
Requests should only be made via https. Non-https requests will be rejected.
Auth
Authentication is via http Basic Auth headers. The id/secret issued should be supplied as the basic auth username and password. Credentials are customer specific.
Headers
Unless a special case Content-Type for both request and response data should be application/json.
Charset should be utf-8.
Endpoints
Host: api.trulywireless.com
Fetching Recordings
GET /integrations/calls/<phonecall-id>/recordings
=> 200
Returns data for all available recording types for phone call.
{
“recordings”: [{“type”: “truly”, “url”: “https://...”},
{“type”: “alien”, “url”: “https://...”},
{“type” :“stereo” “url”: “https://...”},
{“type” :“both” “url”: “https://...”}]
}
GET /integrations/calls/<phonecall-id>/recordings/[truly|alien|stereo|both]
=> 200
Returns the data for a specific recording type
{
“recording”: {“type”: “stereo”,
“url”: “https://...”}
}
Recording Types
truly - Recording of the truly user end of the conversation.
alien - Recording of the non-truly end of the conversation.
stereo - Recording with two channels with Truly user in right channel of recording.
both - Recording with one channel with all parties in a single channel
Sending SMS messages
POST /integrations/sms
Body
{
"to": "+16465551000",
"from": "+14155556060",
"body": "Oh yes that’s the right one"
}
Note: The “from” number must be a number that is associated with the users Truly license group. If that’s not the case the request will be rejected.
Notes
URLs returned in assets objects should not be stored. The URLs expire and become invalid after a predetermined amount of time. Always refetch via recordings endpoint for most up to date URLs.
Credentials are company specific.