Send a Message

Send a message as the user from your own UI, for example an "Ask about my order" button

iOS

Android

Flutter

React Native

Task {
    do {
        try await KindlyWebViewSDK.sendMessage("I need help with my order", newContext: ["orderId": "1234"])
    } catch KindlyWebViewError.chatNotReady {
        KindlyWebViewSDK.displayChat()
    } catch {
        // see Errors
    }
}

Empty text throws KindlyWebViewError.invalidArgument

lifecycleScope.launch {
    try {
        KindlyWebViewSDK.sendMessage("I need help with my order", mapOf("orderId" to "1234")).await()
    } catch (e: KindlyWebViewException.ChatNotReady) {
        KindlyWebViewSDK.launchChat(this@MainActivity)
    }
}

Empty text fails with KindlyWebViewException.InvalidArgument

await KindlyWebViewSDK.sendMessage('I need help with my order', newContext: {'orderId': '1234'});

Without a chat page it fails with chatNotReady. Blank text throws an ArgumentError

await KindlyWebViewSDK.sendMessage('I need help with my order', { newContext: { orderId: '1234' } });

Without a chat page it rejects with CHAT_NOT_READY. Blank text rejects with INVALID_ARGUMENT

The message needs a chat page, so show the chat at least once first. It may be hidden since: then the message is sent without showing the chat. While the page is still loading the message waits, up to 30 seconds. Surrounding whitespace is trimmed, and a message can be up to 10,000 characters

newContext goes with this message only, on top of any context set with setNewContext, and follows the same rules