> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yuko.so/llms.txt
> Use this file to discover all available pages before exploring further.

# WappCloud

> Connect WappCloud as your WhatsApp Business API provider and send approved template messages, with optional URL buttons, from any Yuko workflow.

> [!NOTE]
>
> **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Integrations → WappCloud

## Introduction

WappCloud is a WhatsApp Business API platform for sending template messages. Once connected, the [WhatsApp Workflow node](https://docs.yuko.so/workflows/whatsapp-node.md) can send your approved WappCloud templates whenever a loyalty event fires: points earned, reward redeemed, tier upgraded, points about to expire and so on.

For the provider-agnostic overview of how Yuko's WhatsApp integration works, see [WhatsApp](https://docs.yuko.so/integrations/whatsapp.md).

## When to use WappCloud

* You already send WhatsApp messages through WappCloud.
* You want loyalty events to trigger the same approved templates you use elsewhere.
* You want URL buttons in your messages that link each customer to a personalised page.

## Before you start

> [!TIP]
>
> You have an active WappCloud account connected to the WhatsApp Business API.

> [!TIP]
>
> You have at least one **approved** template in WappCloud.

> [!TIP]
>
> You can find two credentials in WappCloud: an **API key** and an **access token**.

## Connect WappCloud to Yuko

**1. Get your WappCloud credentials**

In WappCloud, generate an API key under **More → API → External API**. Then copy your access token under **More → API Access**.

**2. Open WappCloud in Yuko**

In Shopify admin, go to **Apps → Yuko Loyalty → Integrations**, pick the **WhatsApp** category from the left sidebar, and click **WappCloud**.

**3. Enter both credentials and connect**

Paste the key into **API Key** and the token into **Access Token**, then click **Connect Integration**. Both fields are required. The page shows **Connected**.

**4. Add a WappCloud step to a workflow**

Open any workflow, click **+**, pick **WhatsApp**, and choose the **WappCloud** card from the provider list.

> [!NOTE]
>
> Yuko doesn't test the credentials when you connect. If the key or token is wrong, the integration still shows **Connected**, but WhatsApp steps fail at send time with WappCloud's error. Check a test send after you connect.

## Configure the WappCloud step in a workflow

| Field | What it is | Example |
| - | - | - |
| **Template Name** | Approved template name from WappCloud, exactly as in Meta Business Manager (no spaces) | `loyalty_points_earned` |
| **Add CTA Button** *(optional)* | Turn on to add URL call-to-action buttons with dynamic suffixes | On |
| **CTA Button Count** | How many URL buttons the template has (1–2). Shown when **Add CTA Button** is on. | `1` |
| **CTA Button URL Suffixes** | One dynamic suffix per button, appended to the button's base URL in the template. Supports [shortcodes](https://docs.yuko.so/workflows/whatsapp-node.md#shortcodes). | `{{reward_code}}` |
| **Parameter Count** | Number of body variables in the template (1–10) | `2` |
| **Template Parameters** | One value per body variable, in order. Supports [shortcodes](https://docs.yuko.so/workflows/whatsapp-node.md#shortcodes). | `{{first_name}}`, `{{points_balance}}` |

You must fill in exactly as many parameters and button suffixes as the counts you set. Template names can't contain spaces.

> [!TIP]
>
> The **Template Name**, parameter count and number of URL buttons must match the approved template in WappCloud exactly. A mismatch is the most common reason a send fails.

WappCloud doesn't take a language code from Yuko. The template's language is the one it was approved with in WappCloud.

Yuko sends the customer's phone number from Shopify and adds a leading `+` if it's missing, so make sure stored numbers include the country code.

## Example use case

**Reward-redeemed message with a shop link**

1. In WappCloud, get a template called `loyalty_reward_redeemed` approved, with two body variables (first name, reward name) and one URL button whose base URL is your store's discount link.
2. In Yuko Workflows, build: **Trigger: Redeem Points** → **WhatsApp (WappCloud)**.
3. Set Template Name = `loyalty_reward_redeemed`, Parameter Count = `2`, Parameters = `{{first_name}}`, `{{reward_name}}`.
4. Turn on **Add CTA Button**, set CTA Button Count = `1`, and Button 1 URL Suffix = `{{reward_code}}`.
5. Turn on the workflow.

## Limitations

* **Approved templates only.** Meta must approve every template before it can be sent.
* **No template authoring inside Yuko.** Create and edit templates in WappCloud.
* **Up to 10 body parameters and 2 URL buttons per step.**
* **No delivery status in Yuko.** The workflow step is marked completed or failed based on WappCloud's API response, not on delivered or read events.

## FAQs

> [accordion] The step is marked failed. What do I check?
>
> 1. The API key and access token are correct. 2. The template name matches WappCloud exactly. 3. The template is approved. 4. The parameter count and button count match the template. 5. The customer has a phone number in Shopify. The failure reason is shown in the workflow's [Analytics](https://docs.yuko.so/workflows/analytics.md).

> [accordion] Can I use the same template in several workflows?
>
> Yes. Each WhatsApp node points to one template, and any number of nodes can use the same one.

> [accordion] How do I rotate the API key or access token?
>
> Disconnect WappCloud in Yuko, generate new credentials in WappCloud, then connect again with both values.

## Related

> [card] [AISensy](https://docs.yuko.so/integrations/aisensy.md)
>
> India / SEA — cost-effective high-volume Business API.

> [card] [Zoko](https://docs.yuko.so/integrations/zoko.md)
>
> Shopify-native — fast onboarding, plain / rich / button templates.

> [card] [WATI](https://docs.yuko.so/integrations/wati.md)
>
> Global — named-parameter templates, team inbox.

> [card] [DelightChat](https://docs.yuko.so/integrations/delightchat.md)
>
> Multi-channel — WhatsApp + Instagram + email, automation-driven sends with CTA.

> [card] [Kwik Engage](https://docs.yuko.so/integrations/kwik-engage.md)
>
> India-leaning — templates with optional dynamic-URL CTA buttons.

> [card] [Engati](https://docs.yuko.so/integrations/engati.md)
>
> Conversational AI — namespace-scoped templates.

> [card] [QuickReply.ai](https://docs.yuko.so/integrations/quickreply-ai.md)
>
> AI-first — media headers, dynamic CTA buttons (requires Client ID + Secret Key).

> [card] [Interakt](https://docs.yuko.so/integrations/interakt.md)
>
> India — template messages with CTA URL buttons and callback metadata.

> [card] [BiteSpeed](https://docs.yuko.so/integrations/bitespeed.md)
>
> Shopify-focused — named parameters and optional CTA URLs with shortcodes.

> [card] [BotSpace](https://docs.yuko.so/integrations/botspace.md)
>
> Multi-channel WhatsApp automation — lightweight setup, positional parameters.

> [card] [AskEva](https://docs.yuko.so/integrations/askeva.md)
>
> SEA / MENA — templates with dynamic URL-suffix CTA buttons.

> [card] [Whamaa](https://docs.yuko.so/integrations/whamaa.md)
>
> Template messages with language codes and up to 2 dynamic CTA URL buttons.

> [card] [ConvertWay](https://docs.yuko.so/integrations/convertway.md)
>
> WhatsApp marketing platform — templates with up to 2 dynamic CTA URL buttons.

> [card] [WappCloud](https://docs.yuko.so/integrations/wappcloud.md)
>
> Template messages with up to 2 dynamic CTA URL buttons (requires API Key + Access Token).

> [card] [WhatsApp overview](https://docs.yuko.so/integrations/whatsapp.md)
>
> How Yuko's WhatsApp integration works across all 14 providers.

> [card] [WhatsApp Workflow node](https://docs.yuko.so/workflows/whatsapp-node.md)
>
> Setup, shortcodes, and example workflows.

> [card] [Book a Free Setup Call](https://cal.com/rameshelamathi/yuko-demo)
>
> Talk to our team for personalised setup help.
>
> **Time:** 30 minutes

> [card] [Contact Support](https://yuko.so/support/)
>
> Visit our support hub for help articles, live chat and ticket submission.

> [card] [Browse the Guides](https://docs.yuko.so/getting-started/welcome.md)
>
> Documentation across loyalty, referrals, memberships and more.

> [card] [Install Yuko](https://apps.shopify.com/yuko)
>
> Add Yuko to your Shopify store from the Shopify App Store.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.