Sinch Node.js SDK - v1.5.0
    Preparing search index...

    Interface CustomCalloutRequest

    The custom callout, the server initiates a call from the servers that can be controlled by specifying how the call should progress at each call event.

    interface CustomCalloutRequest {
        ace?: string;
        cli?: string;
        custom?: string;
        destination?: CalloutDestination;
        dtmf?: string;
        ice?: string;
        maxDuration?: number;
        pie?: string;
    }
    Index

    Properties

    ace?: string

    You can use inline SVAML to replace a callback URL when using custom callouts. Ensure that the JSON object is escaped correctly. Example: "{"action": {"name": "RunMenu","locale": "en-US","menus": [{"id": "main","mainPrompt": "#tts[ Welcome to the main menu. Press 1 for a callback or 2 for a cancel</speak>]","timeoutMills": 5000,"options": [ {"dtmf": "1","action": "return(callback)"}, {"dtmf": "2","action": "return(cancel)"}]}]}}"

    cli?: string

    The number that will be displayed as the incoming caller, to set your own CLI, you may use your verified number or your Dashboard virtual number, it must be in E.164 format.

    custom?: string

    Can be used to input custom data.

    destination?: CalloutDestination

    The type of device and number or endpoint to call.

    dtmf?: string

    When the destination picks up, this DTMF tones will be played to the callee. Valid characters in the string are "0"-"9", "#", and "w". A "w" will render a 500 ms pause. For example, "ww1234#w#" will render a 1s pause, the DTMF tones "1", "2", "3", "4" and "#" followed by a 0.5s pause and finally the DTMF tone for "#". This can be used if the callout destination for instance require a conference PIN code or an extension to be entered.

    ice?: string

    You can use inline SVAML to replace a callback URL when using custom callouts. Ensure that the JSON object is escaped correctly. If inline ICE SVAML is passed, exclude cli and destination properties from the customCallout request body. Example: "{"action":{"name":"connectPstn","number":"46000000001","maxDuration":90}}"

    maxDuration?: number

    The maximum amount of time in seconds that the call will last.

    pie?: string

    Note: PIE callbacks are not available for DATA Calls; only PSTN and SIP calls. You can use inline SVAML to replace a callback URL when using custom callouts. Ensure that the JSON object is escaped correctly. A PIE event will contain a value chosen from an IVR choice. Usually a PIE event wil contain a URL to a callback sever that will receive the choice and be able to parse it. This could result in further SVAML or some other application logic function. Example: "https://your-application-server-host/application"