Skip to content
Supporto Spoki

Documentation for Spoki use

  • English
    • Italiano
    • Español
  • English
    • Italiano
    • Español

How to

82
  • Shopify metaobjects for the AI agent: release messages and setup guide
  • “Transform Contact Field” step: when and how to use it
  • Practical guide: how to write a prompt that works
  • How to create a simple automation from the Campaigns section
  • Spoki on your Smartphone – Web App and Notifications
  • “Delay” Step: When and How to Use It
  • Quick Action “If/Else”
  • How to Filter Chats by One or More Tags/Agents/Lists/Tickets
  • Marketing Consent on Spoki: Operational Guide
  • Guide to the Branching Option in Automations
  • Introduction to Using the OTP Code
  • Guida allo step “Attendi risposta”
  • How to Upload a Contact List on Spoki: A Step-by-Step Guide
  • Crafting AI Prompts
  • How to send the content of a message to an external webhook
  • Multiple steps in automation
  • HOW TO TRACK CLICKS ON TEMPLATE MESSAGE LINKS: UTM
  • How to write documents for AI
  • Template suggested by Artificial Intelligence (AI)
  • How to create a marketing funnel on Shopify
  • Integrating Spoki with Meta Listings
  • How to build your own AI Agent
  • Restore all blocked contacts
  • Translate messages and replies if the contact has a different language
  • Transcription and translation of audio in chat
  • Permanently delete a contact on Spoki
  • How to export all messages from a chat as CSV
  • How to change media in the Template before sending it in chat
  • How to create a list for contacts in a specific automation step
  • New features of Active Campaign
  • How to populate a dynamic field
  • How to activate catalog display on WhatsApp
  • How to add Tag in automation before inserting it
  • How to generate a list from Campaign Statistics
  • How to segment clients within Automations.
  • How not to let your recharge expire
  • How to automatically manage who replies/does not reply to a message
  • How to terminate automation manually for specific contacts
  • How to change media in Template before sending it to chat
  • How to export all chat messages as CSV
  • Audio transcription and translation in chat
  • Delete contact permanently on Spoki
  • Train artificial intelligence (AI) on Spoki
  • How to set up a CTA with dynamic field
  • How to automatically manage who replies/doesn’t reply to a message
  • Free messages with buttons
  • How to get a single contact out of all automations
  • Spoki – first steps
  • How to transfer contacts from your Whatsapp app to Spoki
  • How to handle cases when I have to send a chat reply to a customer after 24 hours?
  • How to withdraw from Spoki service
  • HOW TO LINK SPOKI TO FACEBOOK INTERACTION CAMPAIGNS
  • How to manage booking Calendly + Active Campaign + Spoki
  • How to consult automation reporting
  • How to send multi-language messages
  • How can I identify which user has replied in chat to a message?
  • How to populate a dynamic field via CSV upload and submit a campaign
  • How to enable automation for birthday greeting message
  • How to automatically handle those who do not respond
  • How to activate the Woocommerce plugin associated with Spoki Pro
  • How to enable automation for non-working hours
  • How to link Spoki to Facebook campaigns
  • How to activate an automatic message to run on holidays
  • How to link a Chat Button on the website to an automated response
  • How to insert WhatsApp chat button on WordPress site
  • How to update Spoki’s WhatsApp profile
  • Recommended proportions for images in Whatsapp messages
  • How to create template button response automation
  • How to start an automation with API
  • How to enable notifications on Spoki
  • How to lock/unlock contacts automatically
  • How to create new users and assign different roles
  • How to integrate Spoki for your customers into your software
  • How to recover abandoned shopping carts on Woocommerce
  • How to Automatically Send a Reminder Message Using Spoki
  • How to duplicate automations/ templates
  • Managing Free Messages in the Automation Flow
  • How to attribute or remove tags to contacts in a list
  • How to delete multiple contacts
  • Migration from old Twilio provider
  • View only unread chats
  • How to Use the Return Webhook from Spoki to Zapier

Integrations

44
  • Integrate WhatsApp with Google Sheets
  • Integrating Spoki with Facebook forms.
  • Integrating Spoki with Brevo (formerly sendinblue)
  • Integrating WhatsApp with Zapier
  • Integrating WhatsApp with Hubspot
  • Integrating WhatsApp with Qapla’
  • Integrating WhatsApp with ActiveCampaign
  • Klaviyo and Spoki Integration.
  • Integrating WhatsApp with IFTTT
  • Integrate WhatsApp with Zoho
  • Integrate WhatsApp to WPNotif
  • Integrate WhatsApp with Semplisio
  • Integrating Spoki with Webhooks
  • Integrating Calendly with Spoki
  • How to send a Webhook out of Spoki vs. a management system
  • Integrating WhatsApp with Paypal
  • Integrate Spoki with any management system via API
  • Spoki MCP with n8n
  • Spoki MCP with VS Code and GitHub Copilot
  • Spoki MCP with Cursor
  • Spoki MCP with ChatGPT
  • Spoki MCP with Claude
  • Spoki MCP authentication and URL
  • Connect Shopify to Spoki AI Sales Agent
  • Zadarma
  • Configurazione del tuo Spoki Voice Agent
  • Microsoft Dynamics 365 Integration
  • Spoki WhatsApp Chat Chrome Extension
  • Integrate Prestashop to WhatsApp
  • WhatsApp and WooCommerce Integration
  • Integrate WhatsApp with Google Calendar
  • Embed Spoki on your Software
  • Spoki Integration with Connectif: Automating WhatsApp Messages
  • Integrate WhatsApp with Shopify
  • Insert Chat Button on Shopify
  • Get Started with Spoki MCP
  • Sync Klaviyo Lists and Segments with Spoki
  • Gorgias
  • Make
  • Shopify App
  • Ringover
  • Magnews Flow
  • Salesforce Flow

Platform

22
  • Lists
  • Dynamic fields
  • Import CSV from Lists
  • Apply for OBA (Official Business Account) WhatsApp
  • Ticket
  • How to verify the authenticity of Spoki emails
  • Spoki Pixel: Spent Time Website Triggers (v19.25.14)
  • Website Behaviour in Automations: Spoki Pixel Trigger (v19.25.3)
  • New Profile Page (v19.8.0): Redesigned Settings for Clarity and Control
  • Email Marketing Channel Introduced in Spoki (v19.18.0)
  • Spoki Pixel (v18.30.0)
  • New Email Channel Integration (v18.27.0)
  • Deals – User Guide
  • Contact
  • Dashboard
  • Chat
  • Campaigns
  • Template messages
  • Chat buttons
  • Tags
  • Integrations
  • Automations

Onboarding

9
  • Guide to migrating your free Meta number
  • Guide to migrating your number with WhatsApp Business (coexistence)
  • Activation of Spoki with a free Meta number
  • Guide to migrating your number
  • Spoki Activation – Authorization from Meta BM (WhatsApp Business number)
  • 2. Verify Meta Business Manager
  • Before activating Spoki: What you need to know about your existing WhatsApp number
  • Plans and prices | Spoki
  • 3. Spoki Training Course

Strategies

12
  • WhatsApp and Black Friday: here are the automations that will help you sell more products
  • WhatsApp Strategies for Christmas: The Complete Guide to Maximizing Sales and Customer Satisfaction
  • WhatsApp That Sells – Mini Strategic Guide by Sector
  • WhatsApp for E-commerce: How to Turn Conversations into Sales with Spoki
  • Why Spoki AI is Essential in Every Communication and Sales Strategy
  • Reach All Your Contacts Without Exceptions: SMS Integrated into Spoki Automations
  • Practical Guide to Creating, Optimizing, and Approving WhatsApp Templates with Spoki and ChatGPT
  • The 6 Most Effective Automations to Use with Spoki
  • Tips for mass mailings over 10,000 contacts

WhatsApp rules

8
  • “Daily” contact limits
  • Quality of messages sent
  • Types of messages
  • What to do if you have been banned from WhatsApp
  • What to do if your account is in low quality
  • Authorization for use
  • Conversations: Costs and Usage
  • Rules to avoid ban from WhatsApp

Release Notes

4
  • Carousel Template
  • Report Tickets
  • Commerce Triggers
  • Automation step “Start automation”
  • Home
  • Docs
  • How to
  • Shopify metaobjects for the AI agent: release messages and setup guide
View Categories

Shopify metaobjects for the AI agent: release messages and setup guide

External release message (customers) #

Subject: Your AI agent can now read Shopify metaobjects

Your Spoki AI agent can now answer with the content you keep in Shopify metaobjects, not only with what is on the product.

Many stores keep details that change by country or language in metaobjects: colours and coverings, images, prices, availability, delivery times. Until now the agent could only read products, so it could not tell a customer in France which colours of a sofa are sold in France. Now it can.

What the agent can do

  • See which metaobject types your store has.
  • Read the entries of a type and search them by name, for example a model and a country.
  • Follow the links between entries, products and images.

The agent only reads content that is published and visible to your storefront. It never changes anything in your store.

What you need to do

The new options are switched off by default. If you do nothing, your agent keeps working exactly as it does today. To use them:

  1. Add the metaobject permissions to the Shopify app you connected to Spoki: read_metaobjects, read_metaobject_definitions and read_files, next to read_products.
  2. In Spoki, open your Shopify integration under AI Agents > Integrations and Tools and save it again, or create a new one.
  3. Switch on the three new options: List Metaobject Definitions, Get Metaobjects, Get Metaobject.

The step-by-step guide is below, for an existing app and for a new one. If you need help, write to Spoki support.

Internal release message (Support, CS, Sales, AI team) #

Subject: AI agent can read Shopify metaobjects (opt-in per customer)

The AI agent’s Shopify tool has three new read-only options that read metaobjects directly from the customer’s store. It was built for poltronesofà, whose product is a generic container while colours, images, prices and availability per country live in metaobjects.

What shipped

  • Three options in the Shopify integration: List Metaobject Definitions, Get Metaobjects, Get Metaobject.
  • The agent reads live from Shopify with the customer’s own credentials. Nothing is stored in Spoki.
  • Only published content is returned: types with storefront access, active entries, active products.
  • No change in the web app was needed. The options appear in the existing Shopify integration form.

Who is affected

Nobody, until they opt in. The options are off by default, and existing integrations keep working unchanged.

What a customer must do to use it

  1. Add read_metaobjects, read_metaobject_definitions and read_files to their Shopify app. read_products is also required; customers who followed our setup guide already have it.
  2. Save their Shopify integration again in Spoki (or create a new one), so the permissions are re-checked.
  3. Switch on the three options and save.
  4. Add a sentence to the agent’s prompt saying that country-dependent content is in the metaobjects.

What Support should know

SymptomCauseWhat to do
The three options show “Missing required permissions”The Shopify app lacks one of the four scopesFollow the setup guide below, then save the integration again
The options do not appear on an old integrationThe integration was saved before the releaseOpen it, save the credentials again
The agent says a type or entry does not existThe type has no storefront access, or the entry is a draftEnable storefront access on the metaobject definition, set the entry to Active
The agent answers from the product and ignores metaobjectsThe prompt does not mention themAdd the prompt sentence from the guide
The agent cannot find an entrySearch matches words in the entry name onlyName entries with the model and country, or ask with the exact name

Limits to be aware of

  • The agent must know the customer’s country from the conversation. It is not detected automatically.
  • Search works on the entry name. A store that names entries differently makes the agent page through them, which is slower.
  • Tested on staging with a test store (5 of 5 country questions answered correctly). Not yet used by a real customer.

Status and owner

Pull request spoki-ai #658, awaiting AI team review. Tracked in the Notion task Shopify MetaObjects.

Setup guide: before you start #

You need four Shopify permissions (scopes) on the app connected to Spoki, and your metaobjects must be published.

ScopeWhy it is neededLikely already there?
read_metaobjectsRead the metaobject entriesNo, new
read_metaobject_definitionsRead the metaobject types and their fieldsNo, new
read_filesRead the images and files linked from an entryNo, new
read_productsRead the products linked from an entryYes, if you followed the Spoki Shopify guide

If one of the four is missing, the three options stay disabled in Spoki with a “Missing required permissions” warning.

Two things to check in your Shopify admin, under Content > Metaobjects:

  • Storefront access is on for each metaobject definition the agent should read. Types without storefront access are hidden from the agent.
  • Entries are Active, not Draft. Draft entries are hidden from the agent.

Then follow the guide that matches your app:

  • A. You connected Spoki with a Client ID and Client Secret (Dev Dashboard app).
  • B. You connected Spoki with an Admin API access token (older custom app created in your store admin).
  • C. You have no app yet, or you prefer a separate one.

A. Existing app with Client ID and Client Secret (Dev Dashboard) #

You add the scopes by releasing a new version of your app. Your Client ID and Client Secret stay the same.

  1. Open the Shopify Dev Dashboard and select the app you connected to Spoki.
  2. In the left menu, click Versions, then Create version (top right). The form opens pre-filled from your current version.
  3. In the API access section, find the Scopes field. Keep everything that is already there and add, separated by commas: read_metaobjects,read_metaobject_definitions,read_files. Add read_products too if it is not in the list.
  4. Leave the other fields as they are and click Release at the bottom of the form.
  5. In your Shopify store admin, go to Settings > Apps and sales channels, open the app, and approve the updated permissions if Shopify asks.
  6. Continue with “In Spoki” below.

Use the Scopes field, not Optional scopes: optional scopes are not granted automatically.

B. Existing app with an Admin API access token (older custom app) #

This is the app described in the current help article, Connect Shopify to Spoki AI Sales Agent, created in your store admin under Develop apps. You add the scopes in the app’s configuration.

  1. In your Shopify admin, go to Settings > Apps and sales channels > Develop apps.
  2. Open the app you created for Spoki (for example “Spoki AI Integration”).
  3. Open the Configuration tab. In Admin API integration, click Edit (or Configure).
  4. Search for and tick read_metaobjects, read_metaobject_definitions and read_files. Check that read_products is ticked.
  5. Click Save.
  6. Continue with “In Spoki” below. Use the same Admin API access token as before.

The Configuration tab lists the scopes the app has today. Click Edit on Admin API integration to change them:

Type “metaobject” in the filter to find the two metaobject scopes, tick the read_ ones, then filter for “files” and tick read_files:

After saving, open the API credentials tab. If Shopify shows a new Admin API access token with Reveal token once, copy it and replace the token in your Spoki integration. The token is shown only once.

To confirm before sending: whether Shopify always issues a new token after a scope change on these older apps. The screens above are from our test store, where the scopes are already added; I did not change scopes there to test it.

C. New app #

Shopify no longer lets you create the older custom apps in the store admin, so a new app is created in the Dev Dashboard. The full walkthrough is in the help article for the new method: Connect your Shopify store to Spoki AI Sales Agent (Dev Dashboard). The only difference is the list of scopes.

  1. Open the Shopify Dev Dashboard and create an app.
  2. Create its first version. In API access > Scopes, enter the scopes from the Spoki guide and add the metaobject ones. The complete list:

read_products,read_product_listings,write_product_listings,read_orders,write_orders,read_customers,write_customers,read_draft_orders,write_draft_orders,read_metaobjects,read_metaobject_definitions,read_files

  1. Click Release.
  2. Install the app on your store.
  3. In the app’s Settings page, copy the Client ID and the Client secret.
  4. Continue with “In Spoki” below and create a new Shopify integration with these credentials.

If the agent only needs to read products and metaobjects, the four scopes from “Before you start” are enough. The order and customer options then stay disabled in Spoki.

In Spoki: switch the options on #

Spoki checks the Shopify permissions when you save the integration, so it must be saved again after the scopes change.

If you already have a Shopify integration

  1. Go to AI Agents > Integrations and Tools.
  2. Open your Shopify integration and save the credentials again, without changing them.
  3. In the list of Shopify options, switch on List Metaobject Definitions, Get Metaobjects and Get Metaobject.
  4. Save.

If you are creating a new one

  1. Go to AI Agents > Integrations and Tools and click Add Tools, then Create Integration, then Shopify.
  2. Choose Dev Dashboard (Recommended) and enter a name, a description, your store name, the Storefront Access Token, the Client ID and the Client Secret. For an older app, choose Admin API Token (Legacy) instead.
  3. Click Add Integration. The list of options appears.
  4. Switch on the three metaobject options, plus the others you use, and click Create.
  5. Open your agent, go to its Tools tab, click Add Tools and select the integration.

The Shopify integration form in Spoki, with the two connection methods at the top:

The three metaobject options are at the bottom of the Shopify options list. When the app has every permission, all options can be switched on:

Tell the agent where to look

Add a sentence like this to the agent’s prompt, adapted to your store:

Colours, images, prices and availability depend on the customer’s country and are stored in the store’s Shopify metaobjects, not in the products. Always look them up with the metaobject tools before answering, and never guess.

Without it the agent may answer from the product alone.

Check that it works #

Open the agent’s Playground and ask a question whose answer depends on a metaobject, for example “Which colours is the Lario sofa available in for France?”. The agent should answer with the entries of that country only.

On our staging test store the agent answered these five questions correctly:

QuestionAgent’s answer
Which colours is the Lario sofa available in for France?Grigio perla only, 1,540 EUR
Which colours is the Lario sofa available in for Italy?Sabbia, Grigio perla, Blu notte
Is the Taormina sofa sold in Spain?No, Italy only
Is the Dolomiti sofa sold in Spain?No, Italy and France only
Is the Siena sofa available in Terracotta in Italy?No, only Cuoio naturale in Italy

If something is wrong

What you seeWhat to check
“Missing required permissions” on the three optionsOne of the four scopes is missing, or the store has not approved the app update. Fix it, then save the integration again
The options are not in the listSave the integration’s credentials again
The agent cannot find a metaobject typeStorefront access is off for that definition in Shopify
The agent cannot find an entryThe entry is a Draft, or its name does not contain the words asked for
The agent ignores metaobjectsAdd the prompt sentence above
What are your Feelings

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Still stuck? How can we help?

How can we help?

Updated on November 12, 2026
Practical guide: how to write a prompt that works

Powered by BetterDocs

Table of Contents
  • External release message (customers)
  • Internal release message (Support, CS, Sales, AI team)
  • Setup guide: before you start
  • A. Existing app with Client ID and Client Secret (Dev Dashboard)
  • B. Existing app with an Admin API access token (older custom app)
  • C. New app
  • In Spoki: switch the options on
  • Check that it works
DEVELOP YOUR BUSINESS WITH SPOKI AND WHATSAPP
Try now for free

Contacts

  • info@spoki.it
  • +39 351 5495135
  • Informativa Privacy

Menu

  • Home
  • Prices
  • Functionality
  • Integrations
  • Artificial Intelligence
  • About us

Solutions

  • Marketing
  • Sales
  • Customer Care
  • Developers

Support

  • API Documentation
  • Blog
  • Case Study
  • Learning Center
  • Manual

Spoki.it © All rights reserved NextAI Srl P.IVA IT02717930743 Viale Francia snc, 72019 San Vito Dei Normanni (BR) Italy

Soluzioni

  • Marketing
  • Vendita
  • Assistenza Clienti
  • Developers
  • Italiano (Italian)
  • English
  • Español (Spanish)