# TextYess MCP > TextYess MCP Server connects your AI agent directly to WhatsApp marketing data and e-commerce analytics. It lets you manage everything from abandoned cart recovery campaigns and full order tracking to reviewing individual customer conversations—all through natural conversation. Stop switching between dashboards; handle sales operations, campaign performance checks, and product inventory oversight using simple commands. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** conversational-commerce, whatsapp-marketing, ai-sales-agent, e-commerce-analytics, lead-conversion, textyess ## Description TextYess connects your AI agent right into your WhatsApp sales funnels and e-commerce guts. You don't gotta jump between a dozen dashboards just to run the shop; you handle everything—from seeing where customers dropped off to checking inventory levels—all through simple conversation with your agent. **Organization & Setup Details** The `get_organization_details` tool grabs the high-level metadata for your whole TextYess account, giving you a quick overview of what's running. The `get_current_user` tool confirms who's logged in and running the query. To see all the stuff hooked up to TextYess, use `list_connected_integrations`, which lists every e-commerce platform that’s currently connected to your account. You can also verify what automated data syncing is active by using `list_configured_webhooks`, which shows all the webhooks set up for status updates and data sync. **Product Catalog & Inventory Oversight** When you need product info, it's simple. The `get_product_details` tool pulls every specific data point associated with a single product ID. To see what products TextYess is tracking generally, run `list_products`, which gives you an overview of your entire catalog synced from your store. For the master list of sales, use `list_all_orders`; this generates a list of every order placed through conversational commerce channels. You'll also find that `get_organization_details` pulls general metadata about your whole account setup. **Campaign Performance Management** You manage all your WhatsApp marketing campaigns here. First, use `list_marketing_campaigns` to grab a list of every active campaign you’ve set up in the system. To see how well those campaigns are doing, the `get_campaign_analytics` tool retrieves detailed performance metrics for any specific marketing push you name. If you wanna know which sales came directly from a certain campaign, run `get_campaign_conversions`; this lists all orders that originated solely from a defined marketing effort. You can also check if your ongoing campaigns are actually getting delivered by running `get_campaigns_delivery_status`, which verifies the deliverability status and metrics for all active pushes. **Customer Interaction & Sales Review** Keep an eye on what's happening with customers and sales. To review recent customer conversations, use `list_ai_conversations`; this lists the most recent interactions that occurred between a shopper and your AI shopping agent, letting you check quality and tone. If you need to see every single sale made through chat channels, run `list_all_orders` again; it gives you that master record of conversational sales. You can also use `get_product_details` to pull specific data points on any item a customer was interested in during their conversation. ## Tools ### get_campaign_conversions Lists orders that were directly generated by a specific marketing campaign. ### get_campaigns_delivery_status Checks the current deliverability status of all active campaigns. ### get_campaign_analytics Retrieves detailed performance metrics for a specified marketing campaign. ### get_current_user Retrieves the profile information for the authenticated user running the query. ### get_organization_details Pulls general metadata and details about your entire TextYess organization account. ### get_product_details Fetches all specific data points associated with a single product ID. ### list_marketing_campaigns Retrieves a list of all active WhatsApp marketing campaigns you have set up. ### list_ai_conversations Lists the most recent customer interactions that occurred with your AI shopping agent. ### list_connected_integrations Lists all e-commerce platforms that are currently connected to TextYess. ### list_all_orders Generates a list of every order placed through conversational commerce channels. ### list_products Lists every product that has been synced from your e-commerce platform into TextYess. ### list_configured_webhooks Shows all active webhooks configured for data synchronization and status updates. ## Prompt Examples **Prompt:** ``` List all active marketing campaigns in my TextYess account. ``` **Response:** ``` I've retrieved your campaigns. You have 3 active broadcasts including 'Black Friday Preview', 'Abandoned Cart Recovery', and 'New Product Launch'. Which one would you like performance metrics for? ``` **Prompt:** ``` Show me the revenue generated by the 'Abandoned Cart' campaign (ID: camp_10293). ``` **Response:** ``` Fetching analytics... The 'Abandoned Cart' campaign has generated $2,500 in revenue from 15 orders. It has a conversion rate of 12%. Shall I list the individual orders attributed to this campaign? ``` **Prompt:** ``` List the last 3 customer conversations with the AI shopping agent. ``` **Response:** ``` I've fetched the interaction logs. Here are the 3 most recent sessions: User_8823 (Completed Purchase), User_8824 (Question about sizing), and User_8825 (Inquiry about shipping). Would you like to see the full transcript for any of them? ``` ## Capabilities ### Get Campaign Performance Metrics Retrieves detailed analytics for a specific WhatsApp marketing campaign. ### List Orders From Campaigns Generates a list of all customer orders that originated from a defined marketing campaign. ### Check Campaign Delivery Status Verifies the delivery status and deliverability metrics for ongoing campaigns. ### Inspect Product Details Pulls specific data points about a product using its unique identifier. ### Review Customer Conversations Lists recent customer interactions with the AI shopping agent for quality review. ### List All Conversational Orders Provides a comprehensive list of every order placed through conversational sales channels. ### View Connected Integrations Lists and verifies all e-commerce platforms currently connected to the TextYess account. ## Use Cases ### Investigating Low Conversion Rates A marketer sees poor sales after a big broadcast. They ask their agent: 'Show me the revenue from Campaign X.' The agent runs get_campaign_analytics, revealing low clicks. The marketer then uses list_products to check if product descriptions are vague, solving the problem without logging into Google Analytics. ### Auditing a New AI Agent A manager wants to make sure the new sales bot is performing well. They prompt: 'List the last 3 customer conversations.' The agent runs list_ai_conversations, allowing the manager to review recent chats and spot conversational errors before they cost money. ### Pre-Launch Inventory Check A business owner is about to launch a product line. They first run list_products to see what's synced, then use get_product_details on the new SKU to confirm pricing and availability before building any marketing campaigns. ### Compliance Check After an Error An employee suspects a sale went through manually. They prompt: 'List all orders.' The agent runs list_all_orders, providing a comprehensive audit log of every recent purchase to confirm the source and details. ## Benefits - You see campaign revenue immediately. Instead of waiting for manual reports, running 'get_campaign_analytics' gives you real-time metrics—opens, clicks, and total money made from any broadcast. - Order tracking becomes instant. By calling list_all_orders, your agent pulls every conversational commerce sale record, giving you a single source of truth instead of checking multiple checkout systems. - Never worry about missing data again. Running 'list_connected_integrations' lets you verify active webhooks for product and order sync, ensuring Shopify updates show up right away. - Review customer quality control easily. Using list_ai_conversations shows the last few interactions with your shopping agent, letting you quickly spot training gaps or poor service moments. - Product data is always current. You can use 'list_products' to check which items are synced and then call 'get_product_details' to confirm pricing or stock levels before a major campaign launch. ## How It Works The bottom line is you use natural language prompts to execute complex sales and marketing tasks without writing code. 1. Subscribe to the server on Vinkius and enter your TextYess API Key, which you find in your dashboard. 2. Connect your AI client (Claude, Cursor, etc.) to the MCP Server using that key. 3. You can now issue direct commands—like 'List all campaigns' or 'Get analytics for Black Friday'—and get actionable data back. ## Frequently Asked Questions **How do I check my WhatsApp marketing performance using TextYess MCP Server?** You run 'get_campaign_analytics' and specify the campaign ID or name. This returns metrics like opens, clicks, and revenue directly without needing to log into the platform. **What is the difference between list_products and get_product_details in TextYess MCP Server?** list_products gives you a comprehensive roster of every synced item. Use get_product_details when you need specific information—like stock count or current price—for one product only. **Can I track sales from abandoned carts with TextYess MCP Server?** Yes. You can use 'get_campaign_conversions' to specifically list orders that were generated by your cart recovery campaigns, giving you clear attribution data. **Do I need to run get_current_user before using the other tools?** No. While running get_current_user confirms who is authenticated, most of the core functions like list_all_orders work independently by accessing your API-keyed account scope. **How do I check which e-commerce platforms are connected using list_connected_integrations?** It lists all active integrations. You can verify this endpoint quickly to confirm every source—like Shopify or others—is properly linked before running reports. **What is the purpose of running get_organization_details in TextYess MCP Server?** It returns metadata about your entire organizational setup. Run this when setting up new users or checking API key permissions across different user profiles. **How can I audit customer interactions using list_ai_conversations?** This tool pulls the interaction logs for you. You use it to review recent agent chats, making sure your AI shopping agent is maintaining quality conversations. **Where do I check if my product and order sync webhooks are active using list_configured_webhooks?** It lists every configured webhook. This confirms the system is set up to receive real-time updates, which is crucial for accurate product and order data. **Can I see how much revenue a specific WhatsApp campaign generated?** Yes! Use the `get_campaign_analytics` tool and provide the Campaign ID. Your agent will retrieve detailed performance metrics including total revenue and number of orders. **How do I check the stock level for a product in my TextYess catalog?** Run the `get_product_details` query with your Product ID. The agent will retrieve the complete metadata, including current stock status synced from your e-commerce platform. **Is it possible to monitor recent interactions between customers and the AI agent?** Absolutely. Use the `list_ai_conversations` query. The agent will retrieve a log of recent interactions, allowing you to monitor the quality and flow of your conversational sales.