What is quick search and how is it done?

Hipcall quick dial is a service that queries a third-party provider for the number to be dialed and initiates the call automatically. The user performing the quick dial does not need to know the phone number of the person they are trying to reach.

The Hipcall quick search feature allows users to make calls by querying a web service for the phone number they wish to call. For example, a courier may need to call an order owner but is not permitted to know their number under the KVKK. In this case, they can call the quick search service, enter the order number, and call the order owner.

Requirements

  • To use the quick dial feature, your Hipcall package must include the API feature.
  • You will also need the following three fields for quick dial settings
  • Announcement to be read to the user when dialing. For example: “Please enter the order number.”
    • Quick dial extension number (a number between 10 and 9999)
    • Web service URL (required field)
    • If authentication is required for the web service, the web service username and password

How it works

  • The user dials the quick dial extension number. For example, 72.
  • The system reads the audio file uploaded by the user. For example, “Please enter your order number.”
  • The user enters the order number while listening to the audio file. For example, 12345.
  • The system sends the relevant information to the service using the HTTP POST method.
{

  "number": "+908508850000",

  "user_id": 1,

  "uuid": "564aff1e-2141-4925-9c2e-b7dd28b87c16",

  "code":  12345,

  "timestamp": 1719843672,

}
  • Additionally, if you have enabled HTTP Basic Auth, the required basic authentication parameters will be added to the header section of the sent form.
  • In response to this POST request, the Bulutfon system will ask us for the target number to be called. The following json response, containing the phone number along with the area code, will do the job:
{ "destination" : "90532XXXXXX" }
  • The user will hear the announcement, “I am calling the number and connecting you.”
  • The number is called.

Failure scenarios

If communication with the web service fails for any reason, the system reads an announcement to the user indicating the failure and ends the call.

What constitutes a failed communication?

  • If the response HTTP code is not 200
  • If the HTTP request is not answered within 3 seconds
  • If the BASIC AUTH username or password in the web service is incorrect
  • If the incoming JSON format is incorrect
  • If the destination number in the incoming JSON format is not a valid phone number, e.g., 3ASDASDF

Technical support

Our company does not provide technical support for third-party software. Instead, you can submit your questions to developers in the community in Turkish or English.