Connect an AI assistant to HeySale
HeySale speaks the Model Context Protocol, so an assistant such as Claude or ChatGPT can set up a salesperson for a website, install her, and report back — without anyone opening a dashboard.
1. Add the connector
Point your assistant's custom connector at this address and finish the sign-in it asks for:
https://hey.sale/mcp2. What it can do
create_website_salesperson
Reads a website and creates a salesperson for it. Safe to call twice — the same website returns the same salesperson.
check_salesperson_status
Says whether she is still learning the site or ready to talk.
get_salesperson_installation
Returns the one-line script to drop into the site, plus a preview link.
configure_salesperson
Renames her, changes her greeting, or points her at a new domain.
get_salesperson_results
Conversations, leads and minutes used so far.
3. Or call it over HTTP
Every tool has a plain endpoint behind it. Send Idempotency-Key on creates so retries never make a second salesperson.
| POST | /api/public/v1/integrations/salespeople | Create (or reuse) a salesperson for a website. |
| GET | /api/public/v1/integrations/salespeople/status | Learning progress and readiness. |
| GET | /api/public/v1/integrations/salespeople/installation | Embed snippet, preview URL, claim link. |
| PATCH | /api/public/v1/integrations/salespeople | Update name, greeting or domain. |
| GET | /api/public/v1/integrations/salespeople/results | Conversations, leads and usage. |
curl -X POST https://hey.sale/api/public/v1/integrations/salespeople \
-H "content-type: application/json" \
-H "idempotency-key: my-project-123" \
-d '{"website_url":"https://example.com","source":"lovable","external_project_id":"my-project-123"}'4. Install her
The installation call returns one script tag. Put it once, before </body>, on every page. It loads on its own and works with single-page apps.
<script async src="https://hey.sale/api/public/launcher.js?k=PUBLIC_KEY"></script>5. Handing her over
A salesperson made this way starts unclaimed and runs on free minutes, so the website works immediately. The claim link in the installation response is how the site owner takes ownership, keeps every conversation, and decides whether to keep her.
More about how HeySale answers questions for AI assistants: /ai-info.