Building a User Interface

Building a User Interface

Developer partners can use the Healthily Smart Symptom Checker API to integrate world-class, conversational AI into their own apps, websites and messaging platforms.

While Healthily provides the API, our developer partners must create dynamic user interfaces that can represent the responses from the API and allow users to answer questions as part of a conversation flow.

Some of the interface elements that need to be rendered are detailed below.


Single message

When a message is returned by the API, the user interface should display this as a simple text message.

Multiple messages

When multiple messages are returned in the response, these should be separated by a new line or constant height margin.

Your MD ID message

Different to the plain text messages detailed above, this type of message can be considered as an article containing one or more sections.

Any user interface should be capable of rendering the sections which can include images, links, and markdown formatting.

See the API Response Schema - message for further information.


Free text

Where a free text response is required, the interface should support the ability to type a response.

Multiple choice

Single answer

Single answer multiple choice questions should only allow a user to select one answer from a list.


Multi-select questions should allow a user to select one or more answers.

Available Commands

At certain points in the conversation flow, the user can have the ability to exit the conversation. The user interface should accommodate this feature.

What’s Next