Suggestions

close search

Make outbound calls

URL: https://api.stringee.com/v1/call2/callout

HTTP method: POST

Content-Type: application/json

Custom HTTP POST header: Name: X-STRINGEE-AUTH Value: JSON web token (JWT), see Authentication

POST data (body):

{
    "from": {
        "type": "external",
        "number": "STRINGEE_NUMBER",
        "alias": "STRINGEE_NUMBER"
    },
    "to": [{
        "type": "external",
        "number": "TO_NUMBER",
        "alias": "TO_NUMBER"
    }],
    "answer_url": "https://example.com/answerurl",
    "actions": [{
        "action": "talk",
        "text": "Chào mừng bạn đã đến với Stringee"
    }]
}

Field	Type	Require	Description
from	String	Yes	JSON data which specify where's the call from
to	String	Yes	JSON data which specify where's the call to
answer_url	String	Yes, unless not exist actions	The webhook endpoint Stringee retrieve SCCO
actions	String	Yes, unless not exist answer_url	SCCO

Response:

{
    "r": response_code,
    "message": "response_message"
}

Field	Type	Require	Description
r	Int	Yes	Response code
message	String	No	Response message

Sample request

POST /v1/call2/callout HTTP/1.1
Host: https://api.stringee.com
X-STRINGEE-AUTH: json_web_token
Accept: application/json

{
    "from": {
        "type": "external",
        "number": "STRINGEE_NUMBER",
        "alias": "STRINGEE_NUMBER"
    },
    "to": [{
        "type": "external",
        "number": "TO_NUMBER",
        "alias": "TO_NUMBER"
    }],
    "answer_url": "https://example.com/answerurl",
}

Sample response

{"r":0}