talkvak

Quick start

Let an agent message a business's customers.

One MCP door. Every call is for one business, and every message is checked for consent first.

Addresses

Health
GET https://api.talkvak.com/health
MCP
https://api.talkvak.com/mcp (2025-06-18, streamable HTTP)
For agents
https://api.talkvak.com/llms.txt
MCP card
https://api.talkvak.com/.well-known/mcp.json

1. See the tools

curl -s https://api.talkvak.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

2. Send a text for a business

Send the business's key as a bearer token. Ask the business owner for it; developers start at celvak.com/developers. Use purpose transactional for a reply or a reminder and marketing for a promotion. The same idempotency_key never sends twice.

curl -s https://api.talkvak.com/mcp \
  -H 'content-type: application/json' \
  -H "authorization: Bearer $BUSINESS_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
  "params":{"name":"send_text","arguments":{
    "to":"+13055550142","text":"Your table is ready.",
    "purpose":"transactional","idempotency_key":"order-1042"}}}'

3. The tools

  • send_text Send a text from the business's line, only if the person agreed to get it.
  • send_whatsapp Send a WhatsApp message, only if the person agreed (Pro plan and up).
  • send_email Send an email, only if the person agreed to get it.
  • deliver_response Answer a conversation on its own channel.
  • get_conversation A conversation with its last messages.
  • get_status Who the caller is, the business's plan and whether it is on.
  • get_usage Texts used against the plan this month.
  • list_plans The plans and their limits.
  • upgrade_plan A payment link for the owner to approve. Agents never pay.
  • make_call Call a customer. Not available yet.

4. When the answer is no

A refusal is a plain code with a message in English and Spanish. Nothing was sent.

  • consent_required The person has not agreed to this kind of message on this channel. Nothing was sent.
  • opted_out The person replied STOP. Nothing was sent.
  • outside_window The person last wrote more than 24 hours ago, so a reply can't go there now.
  • template_required_outside_session On WhatsApp, after 24 hours only an approved template can go. Send a text instead.
  • compliance_blocked The message didn't pass the check (for example personal details). Nothing was sent.
  • payment_required The business needs an active plan. The owner approves the link.
  • quota_exceeded The business used all the texts in its plan.
  • calls_not_available Calls are not available yet.

When a business is off or over its plan:

{ "error": "payment_required", "checkout_url": "…",
  "approve_by": "human", "message": { "en": "…", "es": "…" } }

Agent sign-in

Signing in an agent on the owner's behalf is not switched on yet. Use the business's key for now.

CelVak for developerstalkvak home