1. Calls
אקסטרה
  • Calls
    • /calls/
      POST
    • /calls/get-recording-urls/
      POST
    • /click2call/
      GET
    • /calls/recording/
      GET
  • SMS
    • /sms/send/
      POST
  • Authorization
    • /auth/key/
      GET
  • Webhooks
    • Call Events
    • Call Events
  1. Calls

/click2call/

GET
https://www.exm.co.il/api/v1/click2call/
Initialize an outgoing call.
Use this endpoint to intiate an outgoing call from the dialer without using its GUI.
Upon success:
1.
The physical phone will get an incoming call from Extra Mobile's dialer for Virtual Number and IVR number (currently: +972778040015 or +972778050015) or the caller_id for others. The caller id for this call may vary according to the parameters passed to the endpoint but you'll get it back in the dialer key of the numbers array. This also referred to as "Leg1 of the call".
2.
When physical answers, a call will be made to destination. The caller id for this call will be the number passed in caller_id. This also referred to as "Leg2 of the call".
HOW IT WORKS?
When calling using the click2call method, we have two calls / "legs", joined into one once both parties answer.
Leg1:
physical gets a call. They see either +972778040015/+972778050015 on their screen if calling from a virtual/ivr number OR if otherwise, they'l see caller_id on their screen.
Leg2:
destination gets a call. They see caller_id on their screen.
IMPORTANT BILLING NOTICE:
API is billing-agnostic, meaning it will make the call regardless of your billing prefrences.
Calling from a virtual number may cost X (or free) while calling from other numbers can cost Y and billed by the minute / minutes plan, all according to terms for the client.
If you're not sure about costs, contact support.
LINKS:
Dialer: https://www.exm.co.il/dialer/
Verified Ids: https://www.exm.co.il/my/verified-ids/

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www.exm.co.il/api/v1/click2call/?caller_id=+972778038038&physical=+972551234567&destination=+97236178888' \
--header 'Authorization: Bearer <token>'
Response Response Example
Success
{
    "success": true,
    "call_id": "z87LXSIIb",
    "numbers": {
        "caller_id": "+972778038038",
        "physical": "+972544444444",
        "destination": "+972533333333",
        "dialer": "+972778050015"
    }
}
Modified at 2024-11-18 06:26:28
Previous
/calls/get-recording-urls/
Next
/calls/recording/
Built with