功能描述

Complete AI voice agent system for eCommerce order confirmation, customer support, and outbound campaigns. 12 production-ready n8n workflows with Vapi AI voi...

使用说明 (SKILL.md)

eComm AI Voice Agent 📞

Name: Ecomm Ai Voice Agent
Author: mhmalvi

A production-ready, 12-workflow AI voice agent system for eCommerce businesses. Handles order confirmation calls, customer support, returns, retries, and outbound campaigns — fully automated.

Problem

eCommerce businesses (especially COD-heavy markets) lose 20-40% of orders to fake orders, no-shows, and unconfirmed deliveries. Manual confirmation calls are expensive and don't scale.

This system automates the entire confirmation and support lifecycle using AI voice calls.

What's Included

12 Production Workflows

#	Workflow	Function
01	Order Intake	Webhook receives new orders, validates, routes by payment type
02	COD Confirmation Call	AI voice call to confirm cash-on-delivery orders
03	Prepaid Confirmation	SMS confirmation + optional high-value voice call
04	Call Result Handler	Processes Vapi callbacks, routes by outcome
05	Retry Engine	Auto-retries unanswered calls on schedule
06	WhatsApp/SMS Fallback	Multi-channel fallback for unreachable customers
07	Returns & FAQ Handler	Intent-based routing for support queries
08	Order Status Updater	Syncs status back to Shopify/WooCommerce
09	CRM & Sheet Logger	Central event logging + HubSpot sync
10	Outbound Campaign	Proactive engagement for unconfirmed orders
11	Daily Report	Automated metrics email to admin
12	Customer Callback	Inbound call queue management

Architecture

Shopify/WooCommerce Order
    │
    ▼
Workflow 01: Order Intake & Routing
    │
    ├── COD Order ──► Workflow 02: AI Voice Call
    │                     │
    │                     ▼
    │               Workflow 04: Parse Call Result
    │                     │
    │                     ├── Confirmed → Fulfill
    │                     ├── Declined → Cancel
    │                     └── No Answer → Workflow 05: Retry
    │                                         │
    │                                         └── Max retries → Workflow 06: SMS/WhatsApp
    │
    ├── Prepaid ──► Workflow 03: SMS + Optional Call
    │
    └── All Events ──► Workflow 09: Central Logger
                            │
                            ├── Google Sheets (Orders, Call Log, Customers)
                            └── HubSpot CRM (optional)

Scheduled:
├── Workflow 05: Retry Engine (configurable intervals)
├── Workflow 08: Status Sync (periodic)
├── Workflow 10: Outbound Campaigns (2-hourly, 9AM-7PM)
└── Workflow 11: Daily Report (once daily)

Required n8n Credentials

You must create these credentials in your n8n instance before importing:

Credential Type	Used For	Placeholder in JSON
Google Sheets OAuth2	Order tracking, call logs, customer CRM	`YOUR_GOOGLE_SHEETS_CREDENTIAL_ID`
SMTP (Gmail or custom)	Daily report emails	`YOUR_SMTP_CREDENTIAL_ID`

All other API keys are configured via n8n environment variables (see below).

Quick Start

1. Prerequisites

n8n v2.4+ (self-hosted)
Vapi.ai account (AI voice calls)
Twilio account (SMS + phone numbers)
Google Sheets OAuth2 credentials
Shopify or WooCommerce store

2. Environment Variables

# Google Sheets
ECOMM_ORDERS_SHEET_ID=your-sheet-id
ECOMM_CALL_LOG_SHEET_ID=your-sheet-id
ECOMM_CUSTOMERS_SHEET_ID=your-sheet-id

# Vapi AI Voice
VAPI_API_URL=https://api.vapi.ai
VAPI_API_KEY=your-vapi-key
VAPI_COD_ASSISTANT_ID=your-assistant-id

# Twilio
TWILIO_ACCOUNT_SID=your-sid
TWILIO_PHONE_NUMBER=+1234567890
TWILIO_AUTH_HEADER=Basic base64encoded
TWILIO_API_URL=https://api.twilio.com/2010-04-01

# Inter-workflow routing
N8N_WEBHOOK_BASE=https://your-n8n-instance.com/webhook

# Email addresses
[email protected]
[email protected]
[email protected]

# Optional
HUBSPOT_API_KEY=your-key
OPENAI_API_KEY=your-key
SHOPIFY_STORE_URL=https://your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=your-shopify-access-token
WOOCOMMERCE_STORE_URL=https://your-store.com
WOOCOMMERCE_AUTH_HEADER=Basic base64encoded
WHATSAPP_API_URL=https://graph.facebook.com/v17.0/YOUR_PHONE_ID
WHATSAPP_API_TOKEN=your-whatsapp-token
ECOMM_CONFIRM_BASE_URL=https://your-store.com/confirm

3. Sheet Setup

Create 3 Google Sheets with these tabs:

Orders: order_id, customer_name, phone, email, amount, payment_type, status, created_at
Call Log: call_id, order_id, phone, outcome, transcript, duration, created_at
Customers: customer_id, name, phone, email, total_orders, last_order_date

4. Import Workflows

Import all 12 workflow JSON files into n8n. Update webhook paths (all prefixed ecomm-ai/).

5. Configure Vapi Assistant

Create a Vapi assistant for COD confirmation with your business script, voice, and language settings.

Use Cases

COD-heavy eCommerce (South Asia, Middle East, Africa) — Confirm orders before shipping
High-ticket items — Voice confirmation for orders above threshold
Subscription businesses — Renewal confirmation calls
B2B order confirmation — Verify large purchase orders
Appointment businesses — Confirm bookings (dentists, salons, clinics)

Revenue Potential

For store owners: Reduce fake orders by 30-50%, saving $1,000-10,000+/month
As a service: Charge $500-2,000/month per client for managed voice confirmation
Per-call pricing: $0.50-2.00 per successful confirmation call

Customization

Voice: Change Vapi assistant for different languages/accents
Script: Customize confirmation dialogue in Vapi dashboard
Channels: Enable/disable WhatsApp, SMS, Email fallbacks
Retry logic: Configure max attempts and intervals
Reporting: Customize daily report metrics and recipients

Requirements

n8n v2.4+ (self-hosted recommended for webhook reliability)
Vapi.ai account ($0.05-0.10 per minute of voice)
Twilio account ($0.0075 per SMS)
Google Sheets API credentials
Shopify/WooCommerce webhook access

安全使用建议

This package appears coherent for importing production n8n workflows that coordinate Vapi AI calls, Twilio SMS, WhatsApp, Shopify/WooCommerce, Google Sheets and optional HubSpot/OpenAI. Before installing: (1) review all 12 workflow JSON files (especially the omitted files) to confirm they don't call unexpected external endpoints or include unreviewed webhooks; (2) provision dedicated API credentials with the minimum scope, not your primary account keys; (3) restrict N8N_WEBHOOK_BASE and n8n webhook endpoints behind authentication and/or IP restrictions so public webhooks can't be abused; (4) confirm whether OPENAI_API_KEY is actually required and why (if unused, don't provide it); (5) test in a staging environment to validate flows and billing effects (calls/SMS will incur cost); (6) audit Google Sheets access and remove any unnecessary write privileges; (7) consider data protection (PII in call transcripts) and retention policies. If you want, I can scan the remaining truncated workflow files for additional surprises or produce a checklist of fields to lock down in each service.

功能分析

Type: OpenClaw Skill Name: ecomm-ai-voice-agent Version: 1.2.2 The skill handles sensitive e-commerce data and integrates with numerous external APIs (Vapi, Twilio, WhatsApp, Shopify, WooCommerce, HubSpot, OpenAI). While its functionality aligns with the stated purpose, several 'code' nodes in workflows/02-cod-confirmation-call.json and workflows/07-returns-faq-handler.json construct AI prompts using direct customer input. This creates a prompt injection vulnerability against the downstream Vapi and OpenAI models, potentially allowing a malicious customer to manipulate the AI's behavior or extract unintended information. This is a significant vulnerability, classifying the skill as suspicious rather than benign, despite no evidence of intentional malicious behavior by the skill developer against the OpenClaw agent or the user's system.

能力评估

✓ Purpose & Capability

Name/description, SKILL.md, and the 12 n8n workflow JSON files consistently implement an eCommerce voice/SMS/WhatsApp automation system. The listed env vars (VAPI, TWILIO, WHATSAPP, SHOPIFY, WOOCOMMERCE, Google Sheets IDs, HUBSPOT, etc.) are expected for the stated integrations.

✓ Instruction Scope

Runtime instructions are limited to importing n8n workflows, configuring n8n credentials, and setting environment variables. The workflow nodes only reference declared env vars, call expected provider endpoints (Vapi, Twilio, WhatsApp, Shopify/WooCommerce via update webhook), and write to Google Sheets as described.

✓ Install Mechanism

No install spec or downloadable code is included — this is instruction-only with workflow JSON files. Nothing is written to disk or fetched by the skill itself during install, which reduces risk.

ℹ Credentials

A large set of sensitive environment variables is required, but they map to the many external services the workflows integrate with. Two minor points: (1) OPENAI_API_KEY is listed among required envs but its usage isn't visible in the truncated workflows provided — confirm whether OpenAI is actually used and why; (2) ensure credentials (TWILIO_AUTH_HEADER, WOOCOMMERCE_AUTH_HEADER, Google OAuth credential) are scoped to least privilege and dedicated accounts.

✓ Persistence & Privilege

always is false and the skill does not request persistent platform-level privileges. It's an n8n workflow bundle that runs inside the user's n8n instance; no autonomous privileged presence or modifications to other skills are present.

版本历史

v1.2.2

Fix: declare all env vars used in workflows in requires.env metadata for security scan compliance

v1.2.1

Initial release: complete n8n workflow automation skill

v1.2.0

Fix: declared required credentials and env vars, removed anyBins, added credential documentation section

v1.1.0

Security fix: removed hardcoded n8n credential IDs. All sensitive values replaced with YOUR_* placeholders.

v1.0.0

Initial release: 12-workflow AI voice agent system for eCommerce order confirmation and support

元数据

Slug ecomm-ai-voice-agent

版本 1.2.2

许可证 —

累计安装 2

当前安装数 2

历史版本数 5

常见问题