Interactive email
Cart, subscription, review, form and carousel blocks inside a VYG email, with signed links, Apple Mail kinetic HTML, and AMP for Gmail and Yahoo.
Interactive email lets a shopper manage a cart, a subscription, a review, a form or a one-click action inside the message, instead of only following a checkout link. You author the template as HTML with <vyg-block> tags. VYG expands each tag three ways: signed links (every inbox), kinetic HTML for Apple Mail, and AMP for Gmail and Yahoo when the sending domain is registered.
The email tools page is the setup path (domain, address, flows, broadcasts). This page is the block contract those tools author against.
Email must be enabled
Interactive blocks use the same email tools as the rest of the channel. They appear only when email is enabled for your brand. Ask your VYG account manager to enable email.
Which assistant server to use
| Who | Server | Sign-in |
|---|---|---|
| LiveRecover operators and agents | agents-mcp.vyg.app/mcp | The LiveRecover agent app |
The brand MCP server at api.vyg.app/mcp does not serve the email tools.
claude mcp add --transport http vyg https://api.vyg.app/mcpStaff connecting to the operator server use https://agents-mcp.vyg.app/mcp instead. Every tool still runs on the brand you signed in to.
Three ways each block renders
| Experience | Who sees it | What it is |
|---|---|---|
| Signed links | Every inbox, including Outlook and Gmail | A table with one tap per action. Fallback for everyone. |
| Kinetic HTML | Apple Mail on iPhone, iPad and Mac | The same table, plus radios and labels so the shopper can pick a variant, quantity or subscription change without leaving Mail. |
| AMP | Gmail and Yahoo, after the sending domain is registered for dynamic email | Live catalog and subscription data, forms that submit in the message. |
A client that cannot do kinetic or AMP always gets the signed-link table. You do not author three templates.
AMP is attached only when the From domain's AMP registration is verified. Until then the send is ordinary HTML + text. Registration is per sending domain and takes a Google form and a Yahoo form; ask your assistant to run email_domain_amp_request after those forms are in.
The <vyg-block> tag
Drop a tag into the HTML body. The inner markup is your brand shell. It must contain exactly one {{{block.body}}} slot — that is where VYG puts the rendered block.
<vyg-block type="cart" config='{"max_items":3,"show_compare_at":true}'> {{{block.body}}} </vyg-block>typeis one ofcart,subscription,custom_action,review,form,carousel.configis a JSON object. Omit it for{}. An invalid config is refused on save asBLOCK_CONTRACT_INVALIDwith the field path.- Block tags are allowed only on templates you create through VYG or the email tools. Imported Klaviyo HTML cannot contain them.
email_block_contracts_list returns each type's JSON Schema, an example config, the actions it may emit, and (for webhook custom actions) the HMAC signing key for the signed-in brand. Never put the key in a template; it is for verifying POSTs your server receives.
Block types
| Type | Shopper can | Typical config |
|---|---|---|
cart | View or rebuild the cart on a Shop Pay checkout, add an accessory, apply a one-time percent code | max_items, optional accessory_collection_handle, either discount_code or discount_mint |
subscription | Delay, skip, swap, reactivate, or add an item to the next order | actions array; optional delay_days_options |
custom_action | One tap that sets a profile property, calls your HTTPS webhook, or applies a discount | mode = cdp_property | webhook | discount |
review | Tap a star rating | platform = judgeme | okendo | vyg (Yotpo and Junip store the rating in VYG only) |
form | Answer up to five steps, including SMS opt-in | steps[] with custom_* property names |
carousel | Page products or images; add a product to the cart | source = collection | products | images |
Checkout never collects a card in the email. Rebuild and add-item land on a Shop Pay-prefilled checkout. Subscription changes run only when the recipient email matches the subscription owner.
How a tap is authorized
Each button is a signed URL of the form https://vyg.app/api/email/action/<token>. The token is a short JWT whose only claims are jti (the action id), bid (your brand) and exp (expiry). The action name, cart lines and choices live on the server, not in the URL.
- Redirect actions (view cart, rebuild, add item): one tap follows the link.
- Write actions (discount, subscription change, review, form, custom): opening the link shows a confirm page. The change runs on submit, so inbox link scanners cannot fire it. A second submit is refused.
Tokens for writes are single-use. Test sends (email_template_test_send_interactive) mint tokens that simulate writes and record dry_run on the interaction.
Size and quality checks
email_template_create / email_template_update / email_template_validate apply the same checks as Settings → Email, plus block and AMP checks:
- HTML body under 100 KB; AMP part under 100 KB (the AMP part is dropped from the send if it is larger, and the HTML still goes out).
- Exactly one
{{{block.body}}}per tag. - No
<script>tags oron…handlers in the HTML. AMP may load only AMP's own runtime scripts. - Webhook URLs must be
httpsand on an allowlisted host (your verified sending domains, your store host, or hosts your account team has added).
Ask the assistant to validate, then preview all three renders, then send you an interactive test:
List the block contracts, draft a cart block with max_items 3, validate it,
preview links, kinetic and AMP, and send me an interactive test.Tools used here
These are the block-specific tools. The rest of the channel (domain, flows, broadcasts, scorecard) stays on the Email tools page.
| Tool | What it does |
|---|---|
email_block_contracts_list | Schema, example config, actions, webhook HMAC key |
email_template_validate | Quality gates and AMP, no save |
email_template_preview_tiers | Links, kinetic and AMP HTML for a sample recipient |
email_template_test_send_interactive | One copy to your inbox with dry-run action tokens |
email_domain_amp_request | Record Google/Yahoo AMP registration form references |
email_interaction_list | In-email taps (recipient masked) |
email_scorecard_get | Attributed revenue, interactions, per-variant arms |
email_flow_variant_add | Pair a static arm with an interactive arm on a flow step |
Next steps
- Email tools for domain setup, templates, flows and broadcasts
- Tool catalog for everything on api.vyg.app/mcp