AI Integration
Use our API with AI assistants like Claude, ChatGPT, or custom agents. We provide a token-optimized skill file that teaches AI how to interact with the echowin API.
Skill File
Our skill file contains everything an AI needs to work with your echowin account: complete API reference, authentication instructions, common workflows, and rate limit information.
https://echo.win/ai-skill.mdClaude Integration
Claude supports custom Skills that extend its capabilities. Our skill file follows the official specification with YAML frontmatter for automatic discovery.
Claude Skills (Recommended)
Add echowin as a custom Skill in Claude. Skills are available on Pro, Max, Team, and Enterprise plans.
- Go to Settings → Capabilities in Claude
- Scroll to the Skills section and click "Add custom skill"
- Download our skill file and upload it:
- Enable the skill and Claude will use it automatically when relevant
- When chatting, provide your API key:
My echowin API key is: ew_your_key_here
Claude Code (Terminal)
For Claude Code users, add the skill to your project for automatic discovery.
- Create the skills directory in your project:
mkdir -p .claude/skills/echowin- Download and save the skill file as
SKILL.md:
curl -o .claude/skills/echowin/SKILL.md https://echo.win/ai-skill.md- Claude will automatically discover the skill and use it when you ask about echowin or need to interact with the API
Note: You can also add skills to ~/.claude/skills/ for global access across all projects.
Network Access Configuration
Claude needs network access to reach echo.win for API calls. Configure this based on your setup:
Claude Code on the Web
By default, Claude Code on the web uses "Limited" network access which doesn't include echo.win. To enable API access:
- Go to your capabilities settings at https://claude.ai/settings/capabilities
- Select your environment and click the settings button
- Change network access from "Limited" to "Full"
Claude Code (Terminal with Sandboxing)
If you have sandboxing enabled, add echo.win to your allowed domains in .claude/settings.json:
{
"sandbox": {
"network": {
"allowedDomains": ["echo.win", "*.echo.win"]
}
}
}OpenClaw Integration
OpenClaw (ClawdBot, MoltBot) supports custom skills that can be configured to work with echowin.
Quick Method
Simply give the skill file URL to your agent and ask it to use it:
Use this skill file for echowin API: https://echo.win/ai-skill.mdThe agent will fetch and use the skill automatically.
Advanced: Manual Setup
For persistent skill configuration across sessions:
- Create the skills directory:
mkdir -p .openclaw/skills/echowin- Download the skill file:
curl -o .openclaw/skills/echowin/SKILL.md https://echo.win/ai-skill.md- Configure in
~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"echowin": {
"enabled": true,
"env": {
"ECHOWIN_API_KEY": "your-api-key-here"
}
}
}
}
}Custom GPTs (ChatGPT)
Create a Custom GPT that can help you manage your echowin account through natural conversation.
Setup Steps
- Go to ChatGPT GPT Editor and create a new GPT
- In the Configure tab, add the following to Instructions:
You are an assistant that helps manage echowin AI phone agents. You can:
- List and manage AI agents
- Search and update knowledgebases
- Manage contacts and tags
- Access call logs and transcripts
Always use the X-API-Key header for authentication.
Base URL: https://echo.win/api/v1- Under Knowledge, upload our skill file (download from ai-skill.md)
- Optional: For live API access, configure Actions with an OpenAPI specification
- Save and publish your GPT
Best Practices
Store API Keys Securely
Use environment variables or secure vaults. Never hardcode keys in prompts or share them in conversations.
Be Specific in Queries
Provide clear, specific instructions. "Update Agent X's greeting" is better than "change something."
Verify Before Changes
Ask the AI to show you what it plans to do before making updates, especially for destructive operations.
Monitor API Usage
Regularly check your API usage in the portal. AI tools can make many requests quickly.
Common AI Workflows
Example prompts you can use with AI assistants to manage your echowin account:
Update Agent Knowledge
"Search my agent's knowledgebase for pricing information and update the answer about our premium plan pricing to $99/month"
Analyze Recent Calls
"Get my last 10 calls and summarize the common questions customers are asking"
Manage Contacts
"Create a new contact for John Smith with phone +14155551234 and tag them as VIP"
Update Agent Behavior
"Update my agent's instructions to be more friendly and casual when greeting customers"
Need Help?
Having trouble setting up AI integration? Check out our other documentation or reach out for support.