How to integrate Apollo AI with Picqer

The instructions below are for desktops and laptops only. 

Connect your live chat to Picqer’s warehouse management API to give customers access to real-time order and product information.


With this integration, your customers can check order statuses and product information easily. This can help enhance customer experience while reducing the workload for your support team.


In this guide, we walk you through the steps to integrate Apollo AI with Picqer using OpenAPI.

Get your OpenAPI schema ready

First, you’ll need your OpenAPI specifications. This can be a JSON or YAML file that defines the communication between Picqer’s API and Apollo AI.


Your OpenAPI specifications contain the required API endpoints, request parameters, and response formats.


Use editors like Swagger Editor to write your specifications, and validate them using Swagger’s validator or any online validator.


Ensure that the endpoints in your OpenAPI specifications match Picqer’s endpoints, and are accessible via Picqer’s base URL.


Here’s an example YAML file with the relevant specifications for orders and products:

Host your OpenAPI schema

Next, host your OpenAPI specification file on a server that allows public access. You can use a repository like GitHub, cloud storage like Amazon S3, or any web hosting service.


Take note of the URL of your specifications file; you’ll need it for the next step. Here’s an example of the URL:

raw.githubusercontent.com/yourusername/yourrepo/main/picquerschema.yaml

Integrate with Apollo AI

Follow these steps to configure your integration:


1. Log in to your tawk.to account.


2. On your dashboard, select the property for which you want to integrate. Hover over the property name to ensure you’ve selected the correct one.
3. Click Add-ons on the top menu.
4. Click Settings under AI Assist.
5. Click Integration/API.

6. Click Add Tool under API.

7. Enter the URL of your OpenAPI specification file in Schema File URL. You can get this from the repository or storage that hosts your OpenAPI specification file. 


Ensure your URL is publicly accessible and correctly points to your JSON or YAML file.


Here's an example:
raw.githubusercontent.com/yourusername/yourrepo/main/picquerschema.yaml

8. Enter the URL of Picqer’s API in API Base URL. The endpoints in your OpenAPI specification will be accessed via this URL. Ensure they match Picqer’s API endpoints to avoid any errors.


An example of the URL is “your-picqer-instance.com/api/v1”, where “your-picqer-instance.com” is your Picqer domain.

9. Select API key, and enter your Picqer API Key and Value. You can get this from your Picqer account. Ensure that you’re using the correct API key to avoid authentication errors.
10. Double-check your details and click Save.
Things to remember
  • Test this integration to ensure accurate data transfer and response generation.

  • Prioritize data security. Follow best practices for API authentication and data encryption.

  • Optimize your API calls to minimize latency and ensure a smooth chat experience for your customers.

  • Ensure your integration can handle increasing chat volumes as your business grows.

If you have feedback about this article, or if you need more help:

Was this article helpful?

7 out of 8 liked this article

Still need help? Message Us