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/mcp

2. What it can do

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/salespeopleCreate (or reuse) a salesperson for a website.
GET/api/public/v1/integrations/salespeople/statusLearning progress and readiness.
GET/api/public/v1/integrations/salespeople/installationEmbed snippet, preview URL, claim link.
PATCH/api/public/v1/integrations/salespeopleUpdate name, greeting or domain.
GET/api/public/v1/integrations/salespeople/resultsConversations, 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.