# Govalo

### Authenticate <a href="#connect" id="connect"></a>

When you're setting up your first workflow with Govalo, you'll need to create a connection by clicking on the **Connect with Govalo** button.

**Important:** You must have the Govalo by Govalo app installed on your Shopify store before authenticating with Govalo. [Click here to install the app.](https://apps.shopify.com/govalo)

![](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FsNarm38EN8B4hMgAuEea%2FAS-GOVALO-CONNECT.png?alt=media\&token=b650af35-9176-48ae-8f71-b9753c9345c3)

You will see a modal in the Govalo app. Click on the **Approve** button to complete the process. You are all set and you can re-use the newly created connection for your future workflows!

### Configuration <a href="#configuring" id="configuring"></a>

#### Create Webhooks for Govalo Triggers <a href="#webhooks" id="webhooks"></a>

**Important:** MESA's Govalo Triggers can only be used by Govalo Premium and Enterprise customers at this time.

When using a Govalo Trigger with Govalo, you will need to create a webhook in your **Govalo** Shopify App.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FZXSmPCjQpGbU9VKEJlb7%2Fas-govalo-trigger1.png?alt=media&#x26;token=c45abb8b-ae0d-4fc4-a897-90a145715f40" alt=""><figcaption></figcaption></figure>

**Follow these instructions to set up your webhook in Govalo.**

1\. In a new tab on your browser, visit the Govalo app from your Shopify Admin's **Apps** page.

{% hint style="info" %}
These instructions assume that you have created a gift card in Govalo already. If you have not, [please configure your first gift card](https://support.govalo.com/article/83-setting-up-govalo) first. Then, proceed to Step 2.
{% endhint %}

2\. Click on **Configure** from the left side bar navigation.

![](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FChx8wz5lRA0c9MFRlQY4%2Fas-govalo-configure.png?alt=media\&token=147330a4-eab3-4dc3-a9ac-3b17ad3471e4)

3\. Then, click on **Webhooks** under the General section. If you do not see **Webhooks** under the **General** section, please contact the [Govalo support](https://support.govalo.com/) to help enable webhooks on your store.\
You can mention that you wish to enable Webhooks on your store (https\://\[\[store domain]].myshopify.com/).

![](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FkD3OkKZCVTWvwYiP6llK%2Fas-govalo-webhooks.png?alt=media\&token=15b5a6d8-9a46-43ea-9340-cf8601bf6b4d)

4\. Going back to MESA, locate your workflow with the Govalo Trigger and click on the Govalo Trigger.

5\. Click on the **Edit** button.

6\. Then, click on the Copy icon next to the **Webhook URL** field.

![](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FkTpAD9FegGOF6weIEZYl%2Fas-govalo-copyurl.png?alt=media\&token=d917b7e1-9373-4709-b2a9-b3a983e92df2)

7\. Go back to the tab with the Govalo app open.

8\. In the Webhook URL field, paste the URL that you just copied from MESA.

9\. You will then want to select the topics which corresponds to the Govalo you added in your workflow. So for MESA's Govalo **Gift Card Created** [trigger](https://docs.getmesa.com/workflow-builder/triggers), you should select **Gift card created** under **Select topics**, as we only want to receive data for this one topic. The topic selected will vary depending on your Govalo trigger.

![](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2F1ZIza6i3D7bpGOcRT6RT%2Fas-govalo-webhookcopy.png?alt=media\&token=6fa8ae18-5d8d-4bef-8f9c-3ffb413f6bbf)

10\. After selecting the relevant topics for your webhook, click on **Save**. You are all set! Head back over to MESA. 😊

#### Create Card action <a href="#create-card" id="create-card"></a>

The **Create Card** action is currently only available to merchants on the [Govalo Enterprise plan](https://govalo.com/pages/pricing) at this time.

![](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FOGOeI6Sj1uh9I0rRpqca%2Fas-govalo-createcardaction.png?alt=media\&token=8b253d99-0cbe-4bec-a979-7ff3d0e312ca)

When adding a **Create Card** action, you will need to fill out some **required** fields before being able to save your workflow.

**Required Fields:**

* **First Name:** The recipient's first name.
* **Last Name:** The recipient's last name.
* **Email:** The recipient's email address.
* **Value:** The gift card value. Whole numbers are recommended. **Example:** 10
* **Event Type:** This is defined by you. Normally used to label why the Gift Card was given. **Example:** birthday
* **Product ID:** The Govalo Gift Card's Shopify Product ID. Click on the Gift Card product that you want to get the Product ID for > Go to the URL at the top and copy the number that comes after **/products/**. Example: **6767472148503** from ../products/6767472148503


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getmesa.com/connect/govalo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
