Manual - HTTP Requester

HTTP requester.png

HTTP Requester Configuration

Notes

  • This module is intended for developers to be able to build an integration themselve
Configuration in CRM application

No need to configure anything in the CRM application itself.

Configuration Bubble Software

You can create your own integration by using the HTTP Requester. 

2b446c56-15a0-483c-83e8-0eab5a07d1e7.png

Lookup request

When a new phone number is detected (after a new call was coming in, or a call was redirected) Bubble will send a HTTP lookup request.

Bubble > Server

{ 
     "action" : "lookup" , 
     "number" : "0612346578" , 
     "number_E164" : "+31612346578" , 
     "notations" : [ 
         "0612346578" , 
         "06-12346578" , 
         "06 12346578" , 
         "061-2346578" , 
         "(06 ) 123 46 578" , 
         "612346578" , 
         "+31612346578" , 
         "0031612346578" , 
         "+31 6 12346578" , 
         "31612346578" , 
         "+31 61 2346578" 
     ], 
     "call" : { 
         "call_id" : "testconnector-timestamp-1630927731549" , 
         "event_timestamp" : "2021-09-06T11:28:51Z" , 
         "call_duration" : "00:00:00" , 
         "number" : "0612346578" , 
         "number_origin" : "TestConnector" , 
         "call_state" : "ringing" , 
         "number_E164" : "+31612346578" , 
         "number_full" : "0031612346578" , 
         "number_international" : "+31612346578" , 
         "number_international_ws" : "+31 6 12346578" , 
         "number_international_compact" : "31612346578" , 
         "number_national" : "0612346578" , 
         "number_national_ws" : "06 12346578" , 
         "number_national_compact" : "612346578" , 
         "direction" : "incoming" , 
         "name" : "Caller Name" , 
         "internal_number" : "201" 
     }, 
     "parameters" : {} 
}


When no result was found, the server should return a HTTP 200 with the following body:

{ 
     "success" : false , 
     "parameters" : {} 
}

When one ore more results are found, the server should return a HTTP 200 with the following body:


 { 
     "success" : true , 
     "parameters" : [ 
         { 
             "name" : "John Doe" , 
             "company_name" : "Legal Company" , 
             "customer_id" : 1234 , 
             "customer_view" : "http://192.168.2.1/customer/1234" 
         }, 
         { 
             "name" : "Bart Storm" , 
             "company_name" : "Legal Company" , 
             "customer_id" : 1234 , 
             "customer_view" : "http://192.168.2.1/customer/1234" 
         } 
     ] 
 }


Call logging

Call registration can be done. Each The following call events will be sent. The server should respons with a HTTP 200.

Call start

Bubble > Server


 { 
     "call_id" : "testconnector-timestamp-1630927731549" , 
     "event_timestamp" : "2021-09-06T11:28:51Z" , 
     "call_duration" : "00:00:00" , 
     "number" : "0612346578" , 
     "number_origin" : "TestConnector" , 
     "call_state" : "ringing" , 
     "number_E164" : "+31612346578" , 
     "number_full" : "0031612346578" , 
     "number_international" : "+31612346578" , 
     "number_international_ws" : "+31 6 12346578" , 
     "number_international_compact" : "31612346578" , 
     "number_national" : "0612346578" , 
     "number_national_ws" : "06 12346578" , 
     "number_national_compact" : "612346578" , 
     "direction" : "incoming" , 
     "action" : "call_event" , 
     "event_type" : "call_start" , 
     "parameters" : {} 
 }


Call update

Bubble > Server

{ 
     "call_id" : "testconnector-timestamp-1630927731549" , 
     "event_timestamp" : "2021-09-06T11:28:57Z" , 
     "call_duration" : "00:00:06" , 
     "number" : "0612346578" , 
     "number_origin" : "TestConnector" , 
     "call_state" : "answered" , 
     "number_E164" : "+31612346578" , 
     "number_full" : "0031612346578" , 
     "number_international" : "+31612346578" , 
     "number_international_ws" : "+31 6 12346578" , 
     "number_international_compact" : "31612346578" , 
     "number_national" : "0612346578" , 
     "number_national_ws" : "06 12346578" , 
     "number_national_compact" : "612346578" , 
     "direction" : "incoming" , 
     "action" : "call_event" , 
     "event_type" : "call_update" , 
     "parameters" : {} 
}


Call end

Bubble >Server

 { 
     "call_id" : "testconnector-timestamp-1630927731549" , 
     "event_timestamp" : "2021-09-06T11:28:59Z" , 
     "call_duration" : "00:00:08" , 
     "number" : "0612346578" , 
     "number_origin" : "TestConnector" , 
     "call_state" : "hangup" , 
     "number_E164" : "+31612346578" , 
     "number_full" : "0031612346578" , 
     "number_international" : "+31612346578" , 
     "number_international_ws" : "+31 6 12346578" , 
     "number_international_compact" : "31612346578" , 
     "number_national" : "0612346578" , 
     "number_national_ws" : "06 12346578" , 
     "number_national_compact" : "612346578" , 
     "direction" : "incoming" , 
     "action" : "call_event" , 
     "event_type" : "call_end" , 
     "parameters" : {} 
 }


Call Registration

Bubble -> Server (supported from Bubble v3.28 and higher)

 { 
     "action" : "call_registration" , 
     "lookup_result" : { 
         "name" : "John Doe" , 
         "company_name" : "Legal Company" , 
         "customer_id" : "1234" , 
         "customer_view" : "http:\/\/192.168.2.1\/customer\/1234" 
     }, 
     "call" : { 
         "call_id" : "test-1683108624351" , 
         "event_timestamp" : "3-5-2023 12:10:39" , 
         "event_timestamp_iso8601" : "2023-05-03T10:10:39Z" , 
         "call_timestamp" : "3-5-2023 12:10:24" , 
         "call_duration" : "00:00:14" , 
         "number" : "0612345678" , 
         "number_origin" : "TestConnector" , 
         "internal_number" : "202" , 
         "external_number" : "+31113405065" , 
         "call_state" : "hangup" , 
         "number_E164" : "+31612345678" , 
         "number_full" : "0031612345678" , 
         "number_international" : "+31612345678" , 
         "number_international_ws" : "+31 6 12345678" , 
         "number_international_compact" : "31612345678" , 
         "number_national" : "0612345678" , 
         "number_national_ws" : "06 12345678" , 
         "number_national_compact" : "612345678" , 
         "direction" : "incoming" 
     }, 
     "subject" : "incoming - 0612345678" , 
     "note" : "Had a very nice chat with the customer. \r\n He will visit the showroom next week." 
 }


Index

Configuration Bubble Software

Lookup request

Call logging

Call start
Call update
Call end
Call Registration

Features

Outbound call possibilities CRM

Click to dial from CRM
Start an outgoing telephone call with one mouse click from your CRM application or any website.

Hotkey dial from CRM
Is a phone number not clickable in your CRM? With this function you can still make a call.


Integration features

Multi result pop-up
Does a phone number occurs multiple times in your CRM application? Click directly to the next result. Do you need this feature but is it not yet available for your integration? Please contact us.

Call registration
Call information can be recorded directly in your CRM under the customer card. Do you need this feature but is it not yet available for your integration? Please contact us.

Call registration (+note)
Call information and call notes can be recorded directly in your CRM under the customer card.

Custom field variables
The custom fields that have been created in the CRM application yourself can also be used to display in the pop-up.

SearchBar
Search CRM contact information from the 'SearchBar' desktop toolbar. From here you can open the customer card, start a phone call directly, send an email/WhatsApp/Microsoft Teams message or view the call history. Do you need this feature but is it not yet available for your integration? Please contact us.


Integration type

Other

Pop-up type

Bubble pop-up
Make use of all the functionalities that Bubble has to offer you

Application pop-up
The CRM application itself has a built-in telephony module. Bubble acts as a gateway (to connect the telephony module of your CRM application and your telephony system) through which you can disable the pop-up of Bubble itself (and therefore also the functions of Bubble).


Standard Bubble pop-up functions

Remote Dialer
A remote dialer is always available on your desktop so that you can start a call quickly and easily.

Pop-up notification
With an incoming, outgoing and forwarded call, an immediate notification with customer information.

Content pop-up customization
Determine the content of the pop-up per user, department or organization with info from your CRM application.

Screen & position customizable
Working with multiple screens? Decide at which screen and in what position you want to see the pop-up.

Single sign-on
No need to remember multiple passwords, login with your Microsoft, Google or Apple account.

Auto-hide
Indicate whether you want the pop-up to remain or to disappear automatically after x time or action.

Multi-languages
Determine the language of the content in the pop-up by adding the words in the language of your choice.

Mute
Mute the pop-ups for a while? Mute the notifications with a simple mouse click until you turn them on again.

Hide internal callers
Don’t want to see a pop-up when a colleague calls you internally? Possibility to turn this function on or off.

Sorting result
Prefer to show contacts first instead of companies when using ‘multi-result’? Decide the order yourself.

Callback request button
No more typing callback requests, but emailing the customer data directly to your colleague via a button

Email button
Do you want to send the caller an email during a telephone conversation? Activate then this button.

To copy button
With the copy function, you have a button that allows you to directly copy data to your clipboard.

Custom action button
Do you have other wishes? Configure a custom button to your liking (e.g. call a specific URL or an .exe)

Click to dial
Start an outgoing telephone call with one mouse click from any website.

Hotkey dial
Is a phone number not clickable in your CRM? With this function you can still make a call.

Recall conversations
In one click, the completed conversation popups can be retrieved to show the information again.

Call back
You can recall the phone number again directly from a ‘retrieved pop-up’ with a simple mouse click.

Talk duration timer
During a phone call, a timer is visible in the pop-up where the duration is displayed in seconds.

Call history
Display the name of the colleague who last spoke or tried to call the caller in the past 3 months.

Call notes
Immediately record your conversation info in a note so that all information is visible to your colleagues.

Multi-tenant mode
With this function you are able to be logged in with multipleaccounts at the same time from one workplace.

Multiple profiles
You can configure multiple profiles so that you as a user are able to switch quickly to another profile.

Updates
With a Bubble license you are always entitled to the latest functions that can be installed with one click.

Native Windows applicatie
Bubble is available as a native software application for Windows.

Native macOS applicatie
Bubble is available as a native software application for macOS


Buttons

Below is the list of available buttons. These are both CRM specific- and generic Bubble functions. Think about invoking a specific URL or script, opening an e-mail or making a callback request. Call Control is only available if your telephony platform supports it.

  • Custom Action (standard button)
  • Send E-mail (standard button)
  • Callback request (standard button)
  • Call Control (standard button)*
  • Send WhatsApp message (standard button)
  • Send Microsoft Teams message (standard button)
  • Open SearchBar (standard button)

Parameters

Determine the content of the pop-up per user, department or organization with information from your CRM package. Below is the list of parameters available from your CRM software.

  • All info returned via the HTTP Requester
Copyright Red Cactus B.V. © 2020 - 2023 Terms and conditions