Ringover
conversationDeleteArchive
This will archive a specific conversation in level 2 on which you have the
right to write.
conversationDeleteMessageArchive
This will archive in level 2 a message in a specific conversation on which you have the right to write.
conversationMessageUnarchive
This will unarchive a message in a specific conversation in which you have the right to write
conversationPostArchive
This will archive in level 1 a specific conversation in which you have the right to write
conversationPostMessageArchive
This will archive in level 1 a message in a specific conversation in which you have the right to write
conversationSetPurpose
This will update the purpose of a specific conversation on which you have the right to read
createWhatsappTemplate
This endpoint creates a Whatsapp message template and returns the template UUID. The template name should not have upper case and special characters.
delete__log
Archive call logs associated with specified channels for the authenticated user's team.
deleteBlacklistsNumbersPhonenumber
Remove a number from your team's blacklist.
deleteCallsCallid
This request allows you to archive a call (Rights monitoring enable = Dashboard effect | Rights monitoring disable = MyRingover effect).
deleteCallsCallidChannelsChannelid
This request allows you to archive a call with channelID (Rights monitoring enable = Dashboard effect | Rights monitoring disable = MyRingover effect).
deleteCampaignsCallCampaignscalllistuuidGroups
Delete group(s)from the specific campaign CALL List
deleteCampaignsCallCampaignscalllistuuidNumbers
Delete number(s) from the queue of specific campaign CALL List
deleteCampaignsCallCampaignscalllistuuidNumbersColumns
Delete column of the numbers of a specific campaign CALL List. The column will be deleted from the 'social_data' field of the numbers. Will also add a log of the operation (c.f. /campaigns/call/{campaignscalllistuuid}/logs).
deleteCampaignsCallCampaignscalllistuuidTags
delete all tags of a specific campaign CALL List
deleteCampaignsCallCampaignscalllistuuidTagsTagid
delete all tags of a specific campaign CALL List
deleteCampaignsCallCampaignscalllistuuidUsers
Delete user(s) from the specific campaign CALL List
deleteContactsContactid
Delete the contact by their id
deleteContactsContactidNumbers
Delete permanently all phone numbers of the contact set in the route
deleteContactsContactidNumbersNumber
Delete the phone number of the contact set in parameter
deleteEmpowerCalls
deleteEmpowerFlagFlagidCallCalluuid
deleteGroupsGroupidUsers
This request allows you to remove a user from a group.
deleteUsersUserid
This request allows you to delete permanently a user from their unique identifier.
deleteUsersUseridBlacklistsNumbersPhonenumber
Remove a number from your user's blacklist (user must have the WRITE rights for users routes).
deleteWhatsappTemplate
This endpoint deletes a Whatsapp message template.
get__teams_plans_data
Retrieve team available plans with name/id/licence counts (used and owned)
getBlacklistsNumbers
Retrieve the phone numbers blacklisted by your team
getBlacklistsNumbersPhonenumber
Check if a number is blacklisted, a 200 HTTP Code response mean the number is blacklisted, a 404 HTTP response mean that the number isn't in the blacklist.
getCalls
This request allows you to retrieve your terminated calls. All the parameters are optional. For a more refined search, please refer to the POST method.
> *Note: In the response, multiple items in the call list can have the same call ID. This behaviour occurs when a call is transferred or when it goes through a standard, you will notice changes in the `from_number/to_number` or `scenario_name/scenario_id` respectively.*
getCallsCallid
This request allows you to retrieve data about the terminated call set in the route parameter. The array <em>list</em> contains all the logs generated by the call, (for example in the case of call forwarding).
getCallsCallidSurveys
getCampaignsCall
Retrieve a list of campaigns calllist
getCampaignsCallCampaignscalllistuuid
Retrieve data about a campaign calllist
getCampaignsCallCampaignscalllistuuidGroups
get the groups for a specific campaign CALL List
getCampaignsCallCampaignscalllistuuidLogs
This is getting all the history
getCampaignsCallCampaignscalllistuuidNumbers
get the queue of numbers for a specific campaign CALL List
getCampaignsCallCampaignscalllistuuidUsers
get the users for a specific campaign CALL List
getCampaignsCallUser
Retrieve campaigns that are started
getConferences
This request allows you to retrieve all the conferences you've set up. The size of the list is indicated in the variable list_count.
getConferencesConferenceid
This request allows you to retrieve a conference.
getContacts
Retrieves your list of contacts (yours and those shared with you). The maximum of rows returned is set in the parameter <em>limit_count</em> (limited to 500 rows).
All the parameters are optional. If the \"search parameter\" is filled, results are sorted by relevance (according to how good the match is).
Note: If a contact has an emoji in their `firstname`, `lastname`, and/or `company`, it will not be displayed in the response body.
getContactsContactid
Retrieve data as well as all `numbers` to a specific `contact` by their identifier
getConversations
This will show the first 100 available conversations by default. When you provide a 'limit_offset' X with a 'limit_count' Y, the first X conversations will be ignored, and the following Y conversations will be returned.
> Warning : You will see the conversations you are allowed to see. If you are a supervisor, you will see the conversations of people you supervise (according to the profile linked to your user) and if you have admin rights, you will see all team users' conversations.
getConversationsConvid
This will get information about specific conversation in which you have the right to read. For messages, only the last is retrieved. To access all messages.
getConversationsConvidMembers
This will show all members in a specific conversation on which you have the right to read
getConversationsConvidMessages
This will show the first 100 available messages in a specific conversation. When you provide a 'limit_offset' X with a 'limit_count' Y, the first X conversations will be ignored, and the following Y conversations will be returned.
getEmpowerCallCalluuid
getEmpowerCallCalluuidMoments
getEmpowerCallCalluuidSummary
getEmpowerCalls
getEmpowerFlags
getEmpowerPlatformPlatformnameChannelChannelid
getEmpowerSummarySummaryid
retrieve a summary
getGroups
This request allows you to retrieve the 100 first groups from your team.
getGroupsGroupid
This request allows you to retrieve data about a group.
getIvrs
This request allows you to retrieve all your ivrs. The size of the list is set in the variable <em>list_count</em>.
getIvrsIvrid
This request allows you to retrieve the ivr corresponding to the identifier indicated in the route.
getIvrsIvridScenarios
This request allows you to retrieve all the scenarios attached to the ivr indicated in the route. The size of the list is set in the variable <em>list_count</em>.
getIvrsIvridScenariosScenarioid
This request allows you to retrieve a scenario's information by indicating in the route its identifier and that of its ivr.
getNumbers
This request allows you to retrieve the `numbers` list for your whole team. The size of the list is set in the variable <em>list_count</em>.
The `is_available` filter is `true` by default and the other filters are `false` by default.
You must have the admin rights in order to use parameters.
getNumbersNumber
This request allows you to retrieve information about an existing number. You simply have to set the phone number in the route (E.164 format).
getPresences
Retrieve presences information about all your users
getProfiles
Retrieve all your team's profiles
getProfilesProfileid
Retrieve the profile associated with the <em>profile_id</em> in the route (user must have the READ rights for users routes).
getSnoozes
This request allows you to get the list of snooze labels in several languages if applicable.
getSummaryByDateOrUserID
This endpoint retrieves a summary of calls for a specified user within a given date range.
It requires permissions associated with the user's token and includes optional limits and offsets.
getTags
This request allows you to retrieve all your tags. The size of the list is set in the variable <em>list_count</em>.
getTagsTagid
This request allows you to retrieve the tag corresponding to the provided identifier.
getTeams
This request allows you to get a complete `team` object that contains a list of `numbers`, `users`, `ivrs`, `conferences`, `tags` and `groups`.
getTranscriptions
Retrieves your team's transcriptions.
For each transcription, in the items of the array of the <em>transcription_data.speeches</em> field, the field <em>channelId</em> takes one of the following values:
- <em>1</em> for the caller emitting the call
- <em>0</em> for the callee receiving the call
If the call is received by a Ringover user while the call is emitted by a call member that is not a registered contact, the <em>contact</em> field will be <em>null</em>.
The maximum rows returned has to be set in the parameter <em>limit_count</em> (limited to 1000 rows). All the parameters are optional.
getTranscriptionsCallid
Retrieves one single transcription by its Call ID.
For the returned transcription, in the items of the array of the <em>transcription_data.speeches</em> field, the field <em>channelId</em> takes one of the following values:
- <em>1</em> for the caller emitting the call
- <em>0</em> for the callee receiving the call
If the call is received by a Ringover user while the call is emitted by a call member that is not a registered contact, the <em>contact</em> field will be <em>null</em>.
getUsers
This request allows you to retrieve all the users on your team, and a list of their numbers for each. The size of the list is set on the attribute `list_count`.
getUsersUserid
This request allows you to retrieve basic data about a user and all phone numbers assigned to them.
getUsersUseridBlacklistsNumbers
Retrieve the phone numbers blacklisted by the user in parameter (user must have the READ rights for users routes).
getUsersUseridBlacklistsNumbersPhonenumber
Check if a number is blacklisted, a 200 HTTP Code response mean the number is blacklisted, a 404 HTTP response mean that the number isn't in the user's blacklist (user must have the READ rights for users routes).
getUsersUseridPlannings
This request allows you to retrieve a user's planning information if the planning of the user is enabled in their settings. Otherwise, `is_planning` will indicate \"false\".
getUsersUseridPresences
This request allows you to retrieve a user's presences information.
getUsersUseridSnoozeLog
This request allows you to get a user's snooze log
getWhatsappAccounts
This endpoint retrieves all WhatsApp accounts associated with the user.
getWhatsappConversations
This endpoint retrieves all Whatsapp conversations. Account UUID is a optional parameter.
getWhatsappTemplates
This endpoint retrieves all WhatsApp templates associated with the account.
patchBlacklistsNumbersPhonenumberCommentNewcomment
Update the comment of a team's blacklisted number
patchCampaignsCallCampaignscalllistuuidMaxretryNewmaxretry
update the max retry of specific campaign CALL List and all associated numbers
patchCampaignsCallCampaignscalllistuuidNameNewname
update the name of specific campaign CALL List
patchCampaignsCallCampaignscalllistuuidNumbers
Update number(s) from the queue of specific campaign CALL List
patchCampaignsCallCampaignscalllistuuidNumbersColumnsRename
Rename column of the numbers of a specific campaign CALL List. The column will be renamed in the 'social_data' field of the numbers. The column can't be renamed to a name that already exists both in or out of 'social_data'. Will also add a log of the operation (c.f. /campaigns/call/{campaignscalllistuuid}/logs).
patchCampaignsCallCampaignscalllistuuidNumbersColumnsSwitch
Switch columns of the numbers of a specific campaign CALL List. Will also add a log of the operation (c.f. /campaigns/call/{campaignscalllistuuid}/logs).
patchCampaignsCallCampaignscalllistuuidStart
Start a campaign CALL List
patchCampaignsCallCampaignscalllistuuidStartEdit
Edit campaign start date CALL List
patchCampaignsCallCampaignscalllistuuidStop
Stop a campaign CALL List
patchConferencesConferenceidPincodePincodeid
This request allows you to update the <em>pincode</em> of the conference indicated in the parameter. You have to set parameters directly in the URL.
patchContactsContactidCompanyCompany
Update the attributed company of the contact indicated in the parameter. You have to set the parameter directly in the URL.
patchContactsContactidFirstnameFirstname
Update the attributed <em>firstname</em> of the contact indicated in the parameter. You have to set the parameter directly in the URL.
patchContactsContactidLastnameLastname
Update the attributed <em>lastname</em> of the contact indicated in the parameter. You have to set the parameter directly in the URL.
patchContactsContactidSharedToggle
Toggle the attribute is_shared of the contact indicated in the parameter
patchGroupsGroupidIsjumperToggle
Toggle the `is_jumper` parameter of a specific group: it allows users to leave and join the group freely. This corresponds to the `Free access` switch of the group in the dashboard.
patchGroupsGroupidUsersUseridRing_durationRingduration
This request allows you to patch the ring duration for a user in a group.
patchUsersUseridBlacklistsNumbersPhonenumberCommentNewcomment
Update the comment of a user's blacklisted number (user must have the WRITE rights for users routes)
post__users_invite
Invite several users and create all associated resources.
postBlacklistsNumbers
Add a number to your team's blacklist, with or without comment (user must have the WRITE rights for users routes)
postCallback
This API route is used to trigger a call in specific IVR queue (the user must have the WRITE right with their API key for the call routes).
<strong>Caution:</strong> this feature adds call redirection fees.
Here is the call workflow:
1. Your user (<em>from_number</em>) receives a call from the recipient's number (<em>to_number</em>)
2. Your user picks up the phone
> A call is automatically made to the recipient (<em>to_number</em>).
postCalls
This request is used to retrieve detailed data of your terminated calls according to the following filters. None of the filters are mandatory but some depends on others. Please check the elements' descriptions.
> *Note: In the response, multiple items in the call list can have the same call ID. This behaviour occurs when a call is transferred or when it goes through a standard, you will notice changes in the `from_number/to_number` or `scenario_name/scenario_id` respectively.*
postCallsCurrent
This request allows you to retrieve all currents calls. This route is only available with the <em>POST</em> method. The current_calls_filter object must be sent.
postCampaignsCallCampaignscalllistuuidGroups
Add group(s) to the specific campaign CALL List
postCampaignsCallCampaignscalllistuuidNumbers
Add number(s) to the queue of specific campaign CALL List
postCampaignsCallCampaignscalllistuuidNumbersColumns
Add column to the numbers of a specific campaign CALL List. The column will be added to the 'social_data' field of the numbers. The column name can't be used in or out of the 'social_data' field. Will also add a log of the operation (c.f. /campaigns/call/{campaignscalllistuuid}/logs).
postCampaignsCallCampaignscalllistuuidReset
Put everything back to zero
postCampaignsCallCampaignscalllistuuidUsers
Add user(s) to the specific campaign CALL List
postChannelsChannelidEventsDtmf
Event to send a DTMF for specific channel
postChannelsChannelidEventsHangup
Event to hangup a specific channel
postChannelsChannelidEventsHoldToggle
Event to enable/disable hold for specific channel
postChannelsChannelidEventsMuteToggle
Event to enable/disable mute for specific channel
postChannelsChannelidEventsRecordToggle
Event to enable/disable record for specific channel
postChannelsChannelidEventsTransfer
Event to transfer a specific channel
postContacts
The function depends on the parameter you send: the JSON <b>contact_filter</b> to retrieve contacts (yours and those shared with you), or <b>contact_creation</b> to create new ones. Only one parameter must be sent.
When creating contacts, each contact is automatically assigned to the user associated with the API_KEY used for the request. You can create up to 50 contacts at once.
When retrieving contacts, the maximum number of contacts returned is defined by the variable <em>limit_count</em> (limited to 500 contacts).
If the \"search\" parameter is filled, results are sorted by relevance (based on how well they match).
Note: If you create a contact with an emoji in the `firstname`, `lastname`, or `company` fields, it will work but the emoji will not be displayed in the response body when retrieving the contact.
postContactsContactidNumbers
Allow to add one or more numbers to the contact set in parameter. Phone numbers must be in international format.
postConversationsConvidRenameNewname
This will update the name of a specific conversation on which you have the right to read
postConversationsConvidUnarchive
This will unarchive a specific conversation in which you have the right to write
postEmpowerChat
postEmpowerFlagFlagidCallCalluuid
postEmpowerUploadCall
Upload a call (audio) or video recording with metadata.
Either send a file or a file_url, not both.
postGroupsGroupidUsers
This request allows you to add a user to a group so that, for example, they have the same rights as other users already in the group. Make sure that it is possible to join the group freely (free access switch).
postIvrsIvridCallback
IVR Callbacks are only available in the Business and Advanced plans. Credit charges may apply based on your destination.
<br>This API route is used to trigger a call in specific IVR queue (the user must have the WRITE right with their API key for the call routes).
postPublicTasksTeam
postPublicTasksTeamCreate_batch
postPushSms
This will send an SMS (the user must have the WRITE rights for Conversations routes). If you worry about your consumption, we invite you to read the following article "<a href='https://www.ringover.com/support/texting-understanding-and-ontrolling-usage'>SMS: understand and control your consumption</a>". Phone numbers must be in E.164 format.
postPushSmsV1
This will send a one-way SMS or Push SMS (the user must be admin and have the WRITE rights for Conversations routes). Phone number must be in E.164 format.
postTags
This request allows you to create a tag.
postUsers
WILL BE DEPRECATED => All new invitations should be done with /users/invite.
This request allows you to create a new user with or without commitment from their email address and phone number (E.164 format).
An invitation email will be sent to the user, they will have to confirm their account to log in to Ringover.
postUsersUseridBlacklistsNumbers
Add a number to a user's blacklist, with or without comment (user must have the WRITE rights for users routes).
postUsersUseridProfilesProfileid
This request allows you to update the user's profile by replacing it with the one corresponding to the id set in parameter.
putCampaignsCallCampaignscalllistuuidScript
if body has no script_uuid and campaign does, it removes the link
putCampaignsCallCampaignscalllistuuidTags
update the tag list of a specific campaign CALL List
putContactsContactid
Update the contact from their id. All fields are mandatory, except the array of <em>numbers</em>. If the array of <em>numbers</em> is set, then the numbers will be purged and replaced by those present in the parameter, otherwise no action will be taken for them.
putContactsContactidNumbersNumber
Update a phone number from the id and the phone number of the contact. The number in the API route is the old number, while the new number is in the json parameter. Phone numbers must be in E.164 format.
putUsersUseridPlannings
This request allows you to replace a user's entire planning with a new one (the planning of the user must be enabled in their settings).
putUsersUseridPlanningsDay
This request allows you to replace a user's day planning with a new one (the planning of the user must be enabled in their settings).
putUsersUseridSnooze
This request allows you to set a user's snooze status
sendWhatsappMessage
sendWhatsappTemplate
This endpoint sends a WhatsApp template message to a specified external number.