Integration · Marketing

Connect Claude & ChatGPT to Unipiazza

Ask your AI how your loyalty programme did last month, what a customer has been up to, or to give a regular a personal promo in Unipiazza. It can register customers, record purchases so they earn loyalty coins, and draft WhatsApp campaigns with a cost estimate. It also reads campaigns, customer lists, birthdays, products and loyalty statistics.

Connect Unipiazza free

Free plan, no credit card. Takes about a minute.

Try asking

“Find the customer with phone +393331234567.”
The AI finds the loyalty customer by exact phone number and shows their details.
“Record a purchase of 24.50 euros for Giulia Rossi.”
It finds the customer and creates a receipt so she earns loyalty coins. A timestamp key guards against counting the same purchase twice.
“Give Marco a promo called 10% off, valid for 14 days.”
It creates a personal promo for him with name, title and 14 days until it expires.

What your AI can do

Loyalty customers

Find customers by email, phone, card code or free text, register new ones and read each customer's activity history.

Receipts and promos

Record purchases that earn loyalty coins, give personal promos, list automatic promos and delete a wrong receipt.

Campaigns and statistics

Draft WhatsApp campaigns with cost estimates, read campaigns and customer lists, and get loyalty and customer statistics per period.

“Which customers have birthdays coming up?”
It lists customer birthdays so you can see who is next.
“Draft a WhatsApp campaign for our VIP list and tell me what it costs.”
It creates the campaign with name, text and target list, then gets the cost estimate. Creating it does not send it.
“How did September compare with August?”
It reads the loyalty statistics for each period so you can compare them.

89 tools for Unipiazza

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_api_keyChanges dataCreate a new api key. API summary: /api/partner/v2/apikeys.
create_autopromoChanges dataCreate a new autopromo. Required: items.
create_boosterChanges dataCreate a new booster. API summary: /api/partner/v2/boosters.
create_customVisible to othersCreate a new custom. Has effects visible outside this system. API summary: /api/partner/v2/email/custom.
create_customerChanges dataRegister a new loyalty customer with `first_name`, `last_name`, `email`, `phone` (E.164) and `birthday`. Set `send_welcome` to send the shop's welcome message to them.
create_giftChanges dataCreate a new gift. API summary: /api/partner/v1/wallet/gift.
create_marketing_campaignVisible to othersCreate a new marketing campaign. Required: name. Has effects visible outside this system.
create_pass_giftcardChanges dataCreate a new pass. Required: pass. API summary: /api/partner/v1/pass/addgiftcard.
create_prizeChanges dataCreate a new prize.
create_productChanges dataCreate a new product. Required: items.
create_product_postChanges dataCreate a new product. API summary: /api/partner/v2/subscriptionproducts.
create_promoChanges dataCreate a new promo.
create_receiptChanges dataRecord a purchase for a customer so they earn loyalty coins: `user_id` and `amount` in euros are required. Use `generated_at` as an idempotency key to avoid double counting.
create_replaceChanges dataCreate a new replace.
create_reset_allChanges dataCreate a new reset all.
create_user_birthdayChanges dataCreate a new birthday for a user.
create_user_create_user_listChanges dataCreate a new user. Required: name, type or shop ids. Search users first to avoid duplicates.
create_user_messageChanges dataCreate a new message for a user. API summary: /api/partner/v2/users/{id}/note.
create_user_reset_default_user_listChanges dataCreate a new user for a user. Search users first to avoid duplicates.
create_user_search_a_user_by_pass_objectChanges dataCreate a new user. Search users first to avoid duplicates.
create_user_update_user_list_membersChanges dataCreate a new user. Required: list id or action. Search users first to avoid duplicates.
create_walletChanges dataCreate a new wallet. API summary: /api/partner/v1/wallet.
create_whatsapp_campaignChanges dataCreate a WhatsApp campaign with a `name`, `body_text`, target `list_ids` and optional `send_at`. This tool does not send it.
delete_api_keyDeletesPermanently delete a api key by api key id. Destructive action; may require approval. API summary: /api/partner/v2/apikeys/{id}.
delete_boosterDeletesPermanently delete a booster by booster id. Destructive action; may require approval. API summary: /api/partner/v2/boosters/{id}.
delete_campaignDeletesPermanently delete a campaign by campaign id. Destructive action; may require approval.
delete_customsMoves moneyPermanently delete a custom. Financial or irreversible action; may require approval. API summary: /api/partner/v2/email/custom.
delete_giftDeletesPermanently delete a gift by pass id. Destructive action; may require approval. API summary: /api/partner/v2/wallets/gift/{passid}.
delete_marketing_campaignDeletesPermanently delete a marketing campaign by marketing campaign id. Destructive action; may require approval.
delete_prizeDeletesPermanently delete a prize by prize id. Destructive action; may require approval. API summary: /api/partner/v1/prizes/{id}.
delete_productDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: /api/partner/v2/subscriptionproducts/{id}.
delete_receiptDeletesPermanently delete a receipt by `receipt_id`. This cannot be undone.
delete_tablet_coverDeletesPermanently delete a tablet cover by cover id. Destructive action; may require approval. API summary: /api/partner/v2/tabletcovers/{coverid}.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: /api/partner/v2/users/{id}.
delete_user_delete_user_listDeletesPermanently delete a user by user id. Destructive action; may require approval.
estimate_whatsapp_campaignGet the cost estimate for sending a WhatsApp campaign by `campaign_id`.
find_customerFind a loyalty customer by exact `email`, `phone`, card/QR `code` or `user_id`.
get_boosterGet one booster by booster id. API summary: /api/partner/v2/boosters/{id}.
get_campaignGet one marketing campaign by `campaign_id`.
get_customGet one custom. API summary: /api/partner/v2/email/custom/verify.
get_customerGet one loyalty customer's details by `user_id`.
get_customer_listGet one customer list by `user_id` (the list's ID).
get_customer_statsGet customer statistics for a `start_date`/`end_date` period.
get_marketing_campaignGet one marketing campaign by marketing campaign id.
get_productGet one product by product id. API summary: /api/partner/v2/subscriptionproducts/{id}.
get_shopGet one shop by shop id. API summary: /api/partner/v1/shops/{id}.
get_shop_get_info_about_a_shopGet one shop by shop id.
get_statsGet the shop's overall loyalty statistics.
get_stats_for_periodGet loyalty statistics for a `start_date`/`end_date` period.
get_whatsapp_campaignGet one WhatsApp campaign by `campaign_id`.
give_customer_promoChanges dataGive a customer a personal promo: `user_id`, `name`, `title` and `expire_days` (days until it expires).
list_activity_historyList loyalty activity across all customers, filtered by `action` and a `start_date`/`end_date` range. Paginated.
list_api_keysList api keys. API summary: /api/partner/v2/apikeys.
list_auto_promosList automatic promos configured for the shop.
list_boostersList boosters. API summary: /api/partner/v2/boosters.
list_campaignsList marketing campaigns. Paginated.
list_customer_birthdaysList customer birthdays.
list_customer_historyList a customer's loyalty activity history by `user_id`. Paginated.
list_customer_listsList customer lists (segments), optionally filtered by `type`.
list_customsList customs. API summary: /api/partner/v2/email/custom.
list_historiesList histories. API summary: /api/partner/v1/wallet/history.
list_history_statsList history stats. API summary: /api/partner/v2/users/historystats.
list_invoicesList invoices. API summary: /api/partner/v1/invoices/.
list_metricsList metrics. API summary: /api/partner/v2/autopromos/metrics.
list_notificationsList notifications. Results are paginated.
list_partner_conventionsList partner conventions. API summary: /api/partner/v2/partnerconventions.
list_productsList the shop's products.
list_products_getList products. API summary: /api/partner/v2/subscriptionproducts.
list_tablet_coversList tablet covers. API summary: /api/partner/v2/tabletcovers.
list_testsList tests. API summary: /api/partner/v2/email/custom/test.
list_timetablesList timetables. API summary: /api/partner/v2/stats/timetable.
list_user_messagesList messages for a user. API summary: /api/partner/v2/users/{id}/note.
list_users_statsList users stats. API summary: /api/partner/v2/users/usersstats.
list_walletsList wallets. API summary: /api/partner/v2/wallets.
search_customersSearch loyalty customers by free text `q`.
send_campaignVisible to othersSend a campaign (campaign id). Has effects visible outside this system.
send_userVisible to othersEmail a user (user id). Has effects visible outside this system.
update_api_keyChanges dataUpdate an existing api key identified by api key id. API summary: /api/partner/v2/apikeys/{id}.
update_boosterChanges dataUpdate an existing booster identified by booster id. API summary: /api/partner/v2/boosters/{id}.
update_campaignChanges dataUpdate an existing campaign identified by campaign id.
update_giftChanges dataUpdate an existing gift identified by pass id. API summary: /api/partner/v2/wallets/gift/{passid}.
update_marketing_campaignVisible to othersUpdate an existing marketing campaign identified by marketing campaign id. Has effects visible outside this system.
update_notification_readsVisible to othersUpdate an existing read identified by notification id. Has effects visible outside this system. API summary: /api/partner/v1/notifications/{id}/read.
update_productChanges dataUpdate an existing product identified by product id. API summary: /api/partner/v2/subscriptionproducts/{id}.
update_receiptChanges dataUpdate an existing receipt identified by receipt id. API summary: /api/partner/v1/receipts/{id}.
update_seensVisible to othersUpdate an existing seen. Has effects visible outside this system. API summary: /api/partner/v1/notifications/seen.
update_shopChanges dataUpdate an existing shop identified by shop id. API summary: /api/partner/v2/shops.
update_tablet_coversVisible to othersUpdate an existing tablet cover. Has effects visible outside this system. API summary: /api/partner/v2/tabletcovers.
update_userChanges dataUpdate an existing user identified by user id.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Unipiazza from the app list.
2
Paste your key
Paste a Unipiazza API key. Log in to your Unipiazza merchant area at partner.unipiazza.it and open the API page (partner.unipiazza.it/openapi). Create a new key and copy it right away, because afterwards only its first half is shown.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Unipiazza?

It can find and search loyalty customers and read their activity history, birthdays, customer lists, products, promos, campaigns and statistics. It can register customers, record receipts, give personal promos, create WhatsApp campaigns, get their cost estimate and delete a receipt.

Does the AI see my Unipiazza credentials?

No. Your Unipiazza API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Deleting a receipt is permanent and registering a customer can send them your welcome message, and both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Unipiazza account.

Does the AI send WhatsApp messages to my customers?

The create_whatsapp_campaign tool creates a campaign with text, target lists and an optional send time, but the tool itself does not send it. The AI can also get the campaign's cost estimate. When the AI registers a new customer, the shop's welcome message is sent only if send_welcome is set.