Comment on page

Adding Decagon to your Swift app

This is a simple guide to adding the Decagon Chatbot to your iOS/Swift app. Broadly, all we need to do is display a WebView pointing to your custom company URL where you want the chatbot to appear. 
Step 1:
Make sure you have the WebKit framework installed. If not, here's how you do it:
In Xcode, click on your project in the Project Navigator.
Select your app's target.
In the tab bar, click on General.
Scroll down to the Frameworks, Libraries, and Embedded Content section.
Click the + button and search for WebKit.framework. Add it to your project.
Step 2:
Set up your WebView. You can do this many ways, but here's an example of creating a UIViewRepresentable wrapper for WKWebView:
struct WebView: UIViewRepresentable {
    let urlString: String
​
    func makeUIView(context: Context) -> WKWebView {
        let webView = WKWebView()
        return webView
    }
​
    func updateUIView(_ uiView: WKWebView, context: Context) {
        if let url = URL(string: urlString) {
            let request = URLRequest(url: url)
            uiView.load(request)
        }
    }
}
Step 3:
Display the WebView where you want your chatbot interface to appear, and point it to your URL. Here's an example of displaying the chatbot in a drawer that slides up when you tap a button:
struct ContentView: View {
    @State private var showWebView = false
​
    var body: some View {
        NavigationView {
            Button("Open Google") {
                showWebView = true
            }
            .sheet(isPresented: $showWebView) {
                WebView(urlString: "https://decagon.ai/mobile/<your company>")
            }
        }
    }
}
That's it. You're done!
Step 4 (Optional):
If you want to pass in user ID and metadata, simply add them on as URL params, like so:
WebView(urlString: "https://decagon.ai/mobile/<your company>?userId=123&name=bob&type=9")
This metadata will be saved along with each conversation.
​
Get Unread Messages Per User
To fetch the unread messages for a user (to display as a badge or indicator), we expose an external REST API that simple returns the total number of unread messages.
GET https://api.decagon.ai/external/num_unread_messages
Params:
token: Your company's unique API key
user_id: The ID of the user who's unread message count you'd like to look up
Example with curl:
curl -H "Content-Type: application/json" \
 "https://api.decagon.ai/external/num_unread_messages?token=<your_token>&user_id=123456"
The response will be of the form:
{
    "count": 2 // An integer
}

Authenticating Users

Adding Decagon to your React Native app

Last modified 25d ago