---
parser: v2
auto_validation: true
time: 10
tags: [ tutorial>beginner, products>sap-conversational-ai, topic>artificial-intelligence, topic>machine-learning, products>sap-business-technology-platform ]
primary_tag: products>sap-conversational-ai
slug: cai-bot-shipping-2-api
canonical_url: https://developers.sap.com/tutorials/cai-bot-shipping-2-api
---

# Add Webhook to Chatbot to Retrieve Tracking Info
<!-- description --> Add a webhook call in the package-tracking chatbot to retrieve information for a specific tracking number, using SAP Conversational AI.

## Prerequisites
 - You have created the chatbot for letting customers request information on their packages, as described in [Create a Chatbot that Lets Customers Track Packages](cai-bot-shipping-1-track-bot).

## You will learn
  - How to set a default webhook endpoint
  - How to call a webhook during a conversation
  - How to display the response

## Intro
In the previous tutorial, you created a chatbot to detect the intent of customers who want to track a package and to get the needed information.

In this tutorial, you will modify the chatbot so it calls an API to retrieve information on the package, based on a tracking number, and displays that information to the customer.

---

### Set default endpoint for webhooks


1. Open your `shippingbot` bot.

2. At the top right, click **Settings**.

    ![Endpoint](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/Endpoint_Settings.png)

3. Click **Versions**, and then click the arrow to the right of **`v1`**.

    ![Versions](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/Endpoint_Edit.png)

4. In the **Bot Builder** field, enter the endpoint to our application on SAP Business Technology Platform: **`https://sapupschatbot.cfapps.eu10.hana.ondemand.com`**

5. Click **Save**.

>This endpoint contains a Python demo script that makes all kinds of API calls, including retrieving package information from UPS. It is described in this [blog](https://blogs.sap.com/2020/02/17/how-to-build-your-first-delivery-tracking-chatbot/).


### Call API to retrieve parcel info


2. Go back to the **Build** tab, and click the **track-parcel** skill.

3. Go to **Actions**.

4. Click **Add New Message Group** (at the bottom).

    ![Add group](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/CallAPI_AddGroup.png)

5. Click **Add Condition**.

    After **If**, click in the field and select **@Yes**, and then click **Save**.

    Click **Connect External Service | Call Webhook**

    ![Add webhook](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/CallAPI_AddWebhook.png)

    For the URL, enter **`/track_parcel`**, and click **Save**.

    ![Service path](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/CallAPI_Service.png)

    Click **Update Conversation** | **Edit Memory**.

    In the **Unset memory field**, and enter **`yes`** (the value is case-sensitive). Click **Add Fields**, and enter **`parcel-number`**. Finally, click **Save**.

    ![Unset memory](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/CallAPI_unset_memory.png)

    >We erase the parcel number because once the user tracked that parcel, it is unlikely they will want to track it again. This way, they can ask to track another parcel.




### Test the bot


You can now test it by starting a conversation to trigger the **`@track-parcel`** intent, supplying the tracking number (e.g., `1Z12345E6205277936`), and saying **Yes**, you want to track the package.

![Conversation with API](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/cai-bot-shipping-2-api/ConversationAPITracking.png)



---