API Action Reference

Action: SMS.Send

This action can be used to send SMS or MMS messages, to any Salesforce record of any object type, as well as to any phone number (i.e. doesn’t need an existent record in Salesforce to get the call initiated).

Parameters

• bodyText – String – Required. Body of the SMS/MMS message.
• fromPhone – String – Optional. Phone number used as the outbound Caller ID when sending the message. If not provided, Fastcall will look for a suitable phone number with SMS capabilities and enabled for sending outbound SMS, to which the user has access either directly, or through a group (see Assignment / Available For, in the phone number detail page in the Fastcall Settings tab).
• mediaURL – String – Optional. URL of the media you want to include with your message. Supported media formats are GIF, PNG, and JPEG.
• phoneNumberFieldName – String – API Name of the record field that holds the phone number to be dialed.
• recordId – String – Optional. Salesforce record ID, associated with the phone number specified in “toPhone”. If provided, Fastcall will associate the SMS record to the Salesforce record, and will also create a Task record associated with this record.
• templateId – String – Optional. Salesforce ID of the Fastcall SMS Template to use for the body. You can get this ID from the template’s details page in the Fastcall Settings. Otherwise, the message’s body is taken from the bodyText parameter.
• toPhone – String – Required. The destination phone number for the message is usually a phone number from a Salesforce record phone number field.
• userId – String – Optional. If you provide the userId parameter, but not the fromPhone, then the Caller ID will be resolved based on that User, instead of the User executing the Flow or Trigger. The User must be a Fastcall User and must have Caller IDs available with support for SMS, otherwise, the action is going to fail.
  
  If you don’t provide the userId parameter, then the User actually invoking the action must be a Fastcall User, and have at least one Caller ID available, otherwise, it will fail.

Returns

A Map<String, Object> with the following properties:

• createdDate – String – DateTime when the message was initially enqueued for delivery.
• direction – String – Outbound or Inbound.
• id – String – Salesforce record ID for the FastCall__SMS_Message__c record.
• owner – String – Id of the Salesforce User or Group set as the owner for the message.
• phoneNumberId – String – Salesforce ID of the Fastcall Phone Number used as Caller ID for sending the message.
• relatedRecordId – String – Salesforce ID of the record associated with the message (Lead, Contact, any record from any standard or custom object type).
• smsId – String – VoIP provider resource ID for the message.
• status – String – Initial delivery status for the message
• taskId – String – Salesforce Task ID for the message.

NOTE: The delivery status for the message is updated in real-time in the FastCall__Status__c field of the FastCall__SMS_Message__c record. So you can track the delivery status of the message by inspecting the FastCall__SMS_Message__c record having the id value provided in the response.

Throws

FastCall.SubscriberAPI.APIException – If an error occurs, an instance of APIException is thrown, with one of the following error codes:

• 100 – SMS could not be sent. Check the VoIP error logs.
• 101 – Body text not provided.
• 103 – Caller ID not found. The Fastcall Admin should provision an SMS capable phone number as Caller ID for the user sending the message.
• 104 – SMS could not be sent. A generic message will contain a more detailed explanation about the issue.
• 105 – The Fastcall setup is missing the SMS capability. Contact Fastcall Support to enable the SMS capability.

Action: Call.Start

Starts an outbound call using Fastcall. When the called party answers, it is connected to a Fastcall IVR (Menu, ACD Call Transfer, Voice Mail, etc.).

Parameters

• fromPhone – String – Optional. Phone number used as the outbound Caller ID. If not provided, Fastcall will try to select one among the phone numbers assigned to the user directly or through a group, that are available for usage as Caller IDs.
• ivrId – String – The Salesforce ID of a Fastcall IVR. This IVR will be executed when the called party answers. It can be an IVR of any type.
• phoneNumberFieldName – String – API Name of the record field that holds the phone number to be dialed.
• recordId – String – Optional. If provided Fastcall will associate the FastCall__Call__c record with this Salesforce record. The Task created will also be associated with this same record.
• toPhone – String – Required. The destination phone number for the Call. This is usually a value taken from a Salesforce record phone number field.
• userId – String – Optional. If you provide the userId parameter, but not the fromPhone, then the Caller ID will be resolved based on that User, instead of the User executing the Flow or Trigger. The User must be a Fastcall User and must have Caller IDs available with support for Voice Calls, otherwise the action is going to fail.
  
  If you don’t provide the userId parameter, then the User actually invoking the action must be a Fastcall User, and have at least one Caller ID available, otherwise, it will fail.

Returns

A Map<String, Object> with the following properties:

• callId – String – VoIP provider resource ID for the call.
• direction – String – Outbound or Inbound.
• id – String – Salesforce record ID for the FastCall__Call__c record.
• ivr – String – Salesforce ID of the Fastcall IVR that the call was connected to.
• owner – String – ID of the Salesforce User or Group set as the owner of the call.
• relatedRecordId – String – Salesforce ID of the record associated with the call (Lead, Contact, any record from any standard or custom object type).
• startTime – String – DateTime when the call was initially enqueued for dialing.
• status – String – Initial status for the call.
• taskId – String – Salesforce Task ID for the call.