LogoLogo
Mluvii webLoginAPIDEMO
English
English
  • ABOUT
  • UPDATES MLUVII
    • 2.125
    • 2.124
    • 2.123
    • Archive
      • 2.122
      • 2.121
      • 2.120
      • 2.119
      • 2.118
      • 2.117
      • 2.116
      • 2.115
      • 2.114
      • 2.113
      • 2.112
      • 2.111
      • 2.110
      • 2.109
      • 2.108
      • 2.107
      • 2.106
      • 2.105
      • 2.104
      • 2.103
      • 2.102
      • 2.101
      • 2.100
      • 2.99
      • 2.98
      • 2.97
      • 2.96
      • 2.95
      • 2.94
      • 2.93
      • 2.92
      • 2.91
      • 2.90
      • 2.89
      • 2.88
      • 2.87
      • 2.86
      • 2.85
      • 2.84
      • 2.83
      • 2.82
      • 2.81
      • 2.80
      • 2.79
      • 2.78
      • 2.77
      • 2.76
      • 2.75
      • 2.72
      • 2.71
      • 2.70
      • 2.68
      • 2.67
      • 2.66
      • 2.65
      • 2.64
      • 2.63
      • 2.61
      • 2.60
      • 2.59
      • 2.58
      • 2.57
      • 2.56
      • 2.55
      • 2.54
      • 2.53
      • 2.52
      • 2.51
      • 2.50
      • 2.49
      • 2.48
      • 2.47
      • 2.46
      • 2.45
      • 2.44
      • 2.43
      • 2.42
      • 2.41
      • 2.40
      • 2.39
      • 2.38
      • 2.37
      • 2.36
      • 2.35
      • 2.34
      • 2.33
      • 2.32
      • 2.31
      • 2.30
      • 2.29
      • 2.28
      • 2.27
      • 2.26
      • 2.25
      • 2.24
      • 2.23
      • 2.22
      • 2.21
      • 2.20
      • 2.19
  • LICENSE TYPES
  • FOR OPERATORS
    • Login
    • Workspace
    • Accept client
    • Client interaction
      • WebChat
      • Client tab
      • Videocall
      • Share
      • Templates
      • Browser
      • End Session
      • Hero Cards
      • E-mail
      • Facebook Messenger
      • Apple Messages for Business
      • WhatsApp
      • VKontakte
      • IP Telephony
      • Telephone campaigns
    • Profile
  • FOR ADMINISTRATORS
    • Company management
      • Licences
      • Users
      • External contacts
      • Performance
      • Operator metrics
      • Dashboards
    • Tenant management
      • Contact directory
      • Sessions
      • All e-mails
      • Operators
      • Campaigns
        • Telephone campaign
          • Campaign Contacts
          • Missed Calls
        • WhatsApp campaign
          • Campaign Contacts
      • Settings
        • Groups
          • By operator utilization
          • To whole group (deprecated)
        • External groups
        • Routing
        • Rules
        • WebChat
        • Forms
          • Forms
          • Hero Cards
        • Chatbots
          • API chatbot
          • Microsoft Bot Framework chatbot
        • WhatsApp
          • Registration process
          • Adding a new phone number
          • Eligible Phone Numbers
          • Pricing
          • Template Messages
            • Conversations
          • Whatsapp ecosystem comparison
          • Data security and GDPR
          • Add WhatsApp widget to website
        • Apple Messages for Business
          • Add Apple widget to website
          • Data security and GDPR
        • Facebook Messenger
          • Add Facebook Messenger widget to website
        • VKontakte
        • E-mails
        • IP Telephony
        • Files
        • Templates
        • Routing visualization
        • Application
          • General
        • Blacklist
        • GDPR
  • FOR IT SPECIALISTS
    • Supported widget methods
    • Add WebChat button to website
    • Add Apple widget to website
    • Customization
      • Customized forms
        • Entry forms
          • Basic entry forms
          • Tenant selection forms
        • Feedback form
          • Basic feedback forms
          • Feedback forms with emojis
          • Feedback form with stars
        • Offline forms
      • Parameters
      • Customized Pop-up
      • Customized functions
      • Customized microsite
    • Public API
      • Authentication
      • Swagger
      • Public API FAQ
      • Webhooks
      • Webhooks FAQ
    • WIDGET API
    • Co-browsing
    • Mobile SDK
      • Android
      • iOS
    • Chatbot connection
      • Microsoft Bot Framework
      • API chatbot
        • API chatbot connection
        • Chatbot API-specific activities and events
      • Supported activities and events
      • Tips and Tutorials
    • Realtime statistics
      • Connection to influx database
      • Existing metrics
      • Examples
      • Grafana
    • Connect Office 365 mailbox
    • Connect Gmail mailbox
    • Software architecture
      • Data encryption
    • Telephony
    • Facebook
    • Files
    • WebChat
    • Cookies
    • Desktop Application
  • SECURITY
  • SYSTEM REQUIREMENTS
    • Minimum HW requirements for operators
    • Minimum SW requirements for operators
    • Supported browsers
    • Audio/Video
    • Supported languages
    • Desktop application
    • Minimum server requirements
    • Mobile application
  • HELPDESK
    • Bug Reporting
    • Manuals
      • Delete browser cookies
      • Delete Local and Session Storage
      • Clear cache memory
      • Add timestamps to logs in the browser console
      • Disconnecting inactive tabs in Google Chrome
    • FAQ
    • Keyboard shortcuts
    • Glossary
Powered by GitBook
On this page
  • Campaigns
  • Chatbot
  • Contacts
  • Companies
  • Departments
  • EmailMessages
  • EmailThreads
  • Forms
  • Groups
  • Guests
  • Phones
  • Sessions
  • Tags
  • Users
  • Webhooks
  • Widgets
  • WhatsApp

Was this helpful?

  1. FOR IT SPECIALISTS
  2. Public API

Swagger

PreviousAuthenticationNextPublic API FAQ

Last updated 1 year ago

Was this helpful?

In this section of the documentation, we have prepared a summary of the most interesting features that you can use in integrations with third-party systems.

For a complete overview of all Public API calls, please visit .

For on-premise deployments, adjust the default URL "app.mluvii.com".

Campaigns

Within campaigns, you can search for lists or specific campaigns. You can also create phone or WhatsApp campaigns, change some of their parameters, or delete them (if they have not been launched). You can also use the API to change the status of campaigns (start, pause, end) or add additional contacts for calling from the Contact Directory.

Chatbot

The API can be used to set up sending a callback URL (not valid for Microsoft Bot Framework chatbots), or sending a selected chatbot activity within a session.

Contacts

Here we can, for example, anonymize a specific record in the Contact directory (within all sessions with a given contact), retrieve a list of contacts from the Contact directory sorted by ID, create a new contact in the Contact directory, retrieve a selected record from the Contact directory by ID, update or delete a specific contact in the Contact directory, or merge contacts into one.

Companies

This area of the API is primarily for the server administrator to use to retrieve the existing rest(s) and more details about each company's settings.

Departments

It is used to get a list of existing tenants and create new tenants within the company, or you can also use the API to add users to existing tenants. You can also check the status of the group queue for each communication channel.

EmailMessages

Here you can export email messages to a .json file. You can export specific messages by ID, or choose bulk export where you can use and combine multiple conditions (sender email, processing date, etc.). Last but not least, you can use the API to generate email messages for your operators. The address and content of the email can already be pre-populated, as well as relevant attachments can be included with the email message.

EmailThreads

In the case of individual threads, you can export them (all messages including operator notes) according to their ID, add or delete tags, get (or update) parameters for a given email thread ID or, for example, get the routing history of an email thread.

Forms

If necessary, you can get information on all available forms.

Groups

Here you have the option to get a list of all existing groups, or just a detail of one in particular.

Guests

Anonymizes the identity of the client. Removes the relationship between the client's cookie and the client's identity ID within the Contact directory.

Phones

It is useful for getting all available phone numbers for a given company and also in case of making an outgoing call or getting data for analysis of a specific phone call.

Sessions

For sessions, the API can be used to search for a session by session ID, anonymize individual sessions, retrieve (or update) parameters by session ID, and add or delete tags by tagID or tag name. You can also get routing information for a given session or initiate an outgoing phone call. It is also possible to forward the current session (within the tenant) to a specific operator, group of operators, or chatbot.

Tags

You can use the API to retrieve tag IDs, names, or tags. This information can be used as the basis for subsequent REST API calls.

Users

In the user area, you can search for users by their ID, retrieve all users, perform a password reset, retrieve the status of individual operators, set operator status, retrieve the status of all operators, and send/delete an invitation.

Webhooks

Here you can get, delete, or update an individual webhook. Get all webhooks, register a webhook for an event, or delete all webhooks.

Widgets

At the widget level, you can use the API to change the widget's state once the current state has been detected. It is possible to modify the overall appearance and behavior of the widget. Alternatively, you can also set the specific form you want.

WhatsApp

The current API has 3 endpoints

  • GET /api/v1/WhatsApp

  • POST /api/v1/WhatsApp/{id}/sendTemplates

  • GET /api/v1/WhatsApp/{id}/sentTemplates

The first endpoint returns all WA subscriptions(id, tenant id, name and phone number). Parameter id is a value that you need for other endpoints.

The second endpoint is for the bulk sending of WA messages with the parameters below

  • formID - id of form in mluvii

  • language - language version of form

  • recipients - an array of contacts to whom you want to send the form (Template Message)

    • contactId - phone number in international format

    • fieldValues - values that will replace placeholders in form. Values must be in the same order as you want them in form

The third endpoint returns data about sent messages for WA subscriptions. You can filter values with * since, offset, and limit attributes.

An overview of all API commands can be found .

here
here
Campaigns
Chatbot
Companies
Contacts
Departments
EmailMessages
EmailThreads
Forms
Groups
Guests
Phones
Sessions
Tags
Users
Webhooks
Widgets
WhatsApp