Tuta AI

Tuta AI provides an AI-powered chat solution that integrates with your online store. It’s like having ChatGPT available to your customers through web chat and WhatsApp, helping you sell products and provide support services.

Key Features

• AI-Powered Chat Assistant: Engage customers with an AI that understands your products and can answer questions 24/7
• Product Knowledge: The AI assistant learns about your products to provide accurate information
• WhatsApp Integration: Connect with customers on their preferred messaging platform
• Sales Analytics: Track conversations that lead to sales
• Multilingual Support: Communicate with customers in multiple languages
• Customizable Appearance: Match the chat widget to your brand
• Easy Setup: Get started in minutes with a simple configuration

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• WooCommerce 5.0 or higher

External Services

IMPORTANT: This plugin requires external services to function properly.

Tuta AI is a Software-as-a-Service (SaaS) platform that provides advanced Artificial Intelligence capabilities for customer support and sales automation. Running sophisticated AI models for natural language understanding, real-time conversation management, and product knowledge inference directly within a standard WordPress hosting environment is not feasible due to the immense computational resources required. Such tasks would overwhelm typical web servers, leading to poor site performance and an unreliable user experience.

Therefore, this plugin must connect to Tuta’s dedicated cloud-based API infrastructure, which is optimized for AI workloads and hosted on Supabase (https://supabase.com). This connection is essential for the plugin to operate and deliver high-quality AI-powered chat and support functionalities.

Service Provider Information:
* Service Name: Tuta AI Platform
* Service Provider: Tuta AI (https://tuta.co)
* Infrastructure: Hosted on Supabase cloud platform (https://supabase.com)
* API Base Domain: Secure cloud-hosted API endpoints (domain varies by deployment)

Why External Services are Required:

1. AI Inference Power: AI models require significant processing power (CPUs, GPUs, specialized hardware) that far exceeds typical WordPress hosting capabilities.
2. Scalability and Reliability: Cloud infrastructure ensures responsive and reliable AI chat during peak traffic.
3. Continuous Improvement: Centralized AI engine allows continuous updates without plugin updates.
4. Specialized Features: WhatsApp integration, analytics, and product knowledge synchronization require optimized external services.

Complete List of External API Endpoints Used:

Important Note: All endpoints listed below are relative paths that are appended to the secure API base domain. The plugin connects to Tuta’s cloud-hosted API infrastructure to access these endpoints.

1. Store Registration & Authentication
* Endpoint: /register-store
* Purpose: Register your WooCommerce store with Tuta service during plugin activation
* Data Sent: Store URL, WordPress admin email, store name, platform versions, locale, country, timezone, currency, business hours
* When: During plugin activation (one-time)

• Endpoint: /token
• Purpose: Obtain short-lived (15 minutes) secure access tokens (JWT) for API authentication
• Data Sent: Store URL, platform identifier, API key

• When: Before most API calls and when tokens need refresh

• Endpoint: /rotate-api-key

• Purpose: Securely rotate store’s API key for enhanced security
• Data Sent: Store ID, store URL, new API key

• When: When admin triggers API key rotation

• Endpoint: /verify-token

• Purpose: Verify token validity for incoming API requests
• Data Sent: Token, store URL
• When: For incoming webhook/API requests validation

2. Chat & Conversation Management
* Endpoint: /messages
* Purpose: Send customer messages to AI engine and receive AI responses
* Data Sent: Customer message text, session ID, customer identifier, store ID, conversation context
* When: Every customer chat interaction

• Endpoint: /get-or-create-conversation
• Purpose: Initialize or retrieve existing conversation sessions
• Data Sent: Session ID, customer information, store ID

• When: When starting new chat sessions or retrieving existing ones

• Endpoint: /get-conversation

• Purpose: Retrieve conversation details and history
• Data Sent: Session ID or conversation ID

• When: When displaying conversation history in admin

• Endpoint: /check-conversation-response

• Purpose: Check for new AI responses in ongoing conversations
• Data Sent: Conversation UUID

• When: Polling for new responses in active conversations

• Endpoint: /conversations

• Purpose: Retrieve filtered list of conversations for admin dashboard
• Data Sent: Date filters, channel filters, pagination parameters
• When: When admin views conversation lists

3. AI Agent Configuration
* Endpoint: /update-agent
* Purpose: Save and retrieve AI agent configuration (personality, business details, FAQs)
* Data Sent: Agent settings, business information, product knowledge instructions
* When: When admin saves AI configuration or plugin fetches current settings

4. Product & Content Synchronization
* Endpoint: /product-update
* Purpose: Sync individual product updates to AI knowledge base
* Data Sent: Product ID, product data (name, description, price, attributes)
* When: When products are created, updated, or deleted

• Endpoint: /upsert-products
• Purpose: Bulk synchronization of product catalog to AI knowledge base
• Data Sent: Complete product data in structured format

• When: During initial setup or bulk product synchronization

• Endpoint: /upsert-pages

• Purpose: Sync website pages/content to AI knowledge base
• Data Sent: Page content, URLs, metadata
• When: When syncing website content for AI training

5. Order & Sales Integration
* Endpoint: /order-status
* Purpose: Update order status information for AI context
* Data Sent: Order ID, status, customer information
* When: When order status changes

• Endpoint: /new-order
• Purpose: Notify AI system of new orders for analytics and context
• Data Sent: Order details, customer information, products purchased
• When: When new orders are placed

6. Analytics & Statistics
* Endpoint: /get-stats
* Purpose: Retrieve general chat and AI performance statistics
* Data Sent: Date ranges, filter parameters
* When: When admin views analytics dashboard

• Endpoint: /conversation-stats
• Purpose: Retrieve detailed conversation analytics and credit usage
• Data Sent: Date ranges, conversation filters, breakdown parameters

• When: When admin views conversation analytics and credit usage statistics

• Endpoint: /stats/ai-sales

• Purpose: Retrieve AI-generated sales revenue and order statistics
• Data Sent: Period parameter (month, week, etc.)
• When: When admin views AI sales performance metrics

7. Subscription & Billing Management
* Endpoint: /get-plans
* Purpose: Retrieve available subscription plans and pricing
* Data Sent: Language preference for localized pricing
* When: When admin views subscription options

• Endpoint: /plans
• Purpose: Retrieve subscription plans (alternative endpoint)
• Data Sent: Store identification

• When: When admin accesses plan information

• Endpoint: /plans/current

• Purpose: Retrieve current active subscription plan details
• Data Sent: Store identification

• When: When admin views current plan status

• Endpoint: /select-plan

• Purpose: Process subscription plan selection
• Data Sent: Selected plan details, store information

• When: When admin selects a subscription plan

• Endpoint: /change-plan

• Purpose: Change existing subscription plan
• Data Sent: New plan details, store information

• When: When admin upgrades or downgrades subscription

• Endpoint: /terminate-subscription

• Purpose: Cancel or modify subscription
• Data Sent: Subscription details, cancellation reason

• When: When admin cancels subscription

• Endpoint: /get-paypro-config

• Purpose: Retrieve payment configuration for subscription management
• Data Sent: Store ID for account identification
• When: When accessing billing/payment sections

8. WhatsApp Integration
* Endpoint: /get-whatsapp-config
* Purpose: Retrieve WhatsApp integration configuration and status
* Data Sent: Store ID for account identification
* When: When accessing WhatsApp settings or checking connection status

• Endpoint: /sync-whatsapp-contacts
• Purpose: Synchronize WhatsApp contacts with Tuta system
• Data Sent: Store ID, contact synchronization parameters

• When: When admin triggers WhatsApp contact synchronization

• Endpoint: /sync-whatsapp-history

• Purpose: Synchronize WhatsApp conversation history
• Data Sent: Store ID, history synchronization parameters
• When: When admin triggers WhatsApp history synchronization

Data Privacy and Security:
* All communication uses HTTPS encryption
* Short-lived JWT tokens (15 minutes) for enhanced security
* No sensitive customer data stored permanently on external servers
* Conversation data used only for AI response generation and analytics
* Compliance with data protection regulations

Legal Information:
* Terms of Service: https://tuta.co/terms
* Privacy Policy: https://tuta.co/privacy

By using the Tuta AI plugin, you acknowledge and agree to these data transfers and the use of our external services as necessary for the plugin’s functionality and the provision of advanced AI features.