Data Binding

The Chat enables you to bind the message list to streaming data.

Data Model

The Chat component defines interfaces for the following entities:

  • User—A unique participant in the conversation.
  • Message—The metadata and content of each message.
  • Attachment—The multimedia or additional information which is associated with a chat message.
  • Action—A suggested quick action in reply to a message. For example, a text reply, external link, or phone call.

As a minimum data-binding configuration for the Chat, provide a list of messages and a user instance which identify the local participant.

User Identity

The user entity identifies the local user. The messages that are authored by the user appear on the right-hand side of the message list.

import { Chat } from '@progress/kendo-react-conversational-ui';


class App extends React.Component {
    constructor(props) {
        super(props);
        this.user = {
            id: 1,                      // Required field
            name: 'Jane',               // Optional
            avatarUrl: '/profile.png'   // Optional
        };
    }
    render() {
        return (
            <div>
                <Chat user={this.user}</Chat>
            </div>
        );
    }
}

ReactDOM.render(
    <App />,
    document.querySelector('my-app')
);

Binding to Message Data

Typically, Chat messages stream from a remote service. To bind the Chat to the stream, utilize a remote service that will stream data and can manage to provide automated responses. Our demo using the Google DialogFlow is one of the possible remote services that can be used.

Posting Messages

When you set up the messages stream set the new messages to the state as well in order to update the component.

The following example demonstrates how to accept the local messages in the sendMessage event and merge them with the incoming messages.

import React from 'react';
import ReactDOM from 'react-dom';
import { Chat } from '@progress/kendo-react-conversational-ui';


class App extends React.Component {
    constructor(props) {
        super(props);
        this.user = {
            id: 1,
            avatarUrl: "https://via.placeholder.com/24/008000/008000.png"
        };
        this.state = {
            messages: []
        };
    }

    addNewMessage = (event) => {
        this.setState((prevState) => {
            return { messages: [ ...prevState.messages, event.message ] };
        });
    };

    render() {
        return (
            <div>
                <Chat user={this.user}
                    messages={this.state.messages}
                    onMessageSend={this.addNewMessage}
                    width={400}>
                </Chat>
            </div>
        );
    }
}

ReactDOM.render(
    <App />,
    document.querySelector('my-app')
);

In this article