Inicio rápido

Deja que un agente escriba a los clientes de un negocio.

Una sola puerta MCP. Cada llamada es para un solo negocio, y cada mensaje se revisa primero por el permiso.

Direcciones

Estado
GET https://api.talkvak.com/health
MCP
https://api.talkvak.com/mcp (2025-06-18, HTTP con streaming)
Para agentes
https://api.talkvak.com/llms.txt
Tarjeta MCP
https://api.talkvak.com/.well-known/mcp.json

1. Mira las herramientas

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

2. Envía un mensaje de parte de un negocio

Envía la clave del negocio como token bearer. Pídela al dueño del negocio; los desarrolladores empiezan en celvak.com/developers. Usa purpose transactional para una respuesta o un recordatorio y marketing para una promoción. La misma idempotency_key nunca envía dos veces.

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. Las herramientas

  • send_text Envía un mensaje de texto desde la línea del negocio, solo si la persona aceptó recibirlo.
  • send_whatsapp Envía un WhatsApp, solo si la persona aceptó (plan Pro y superiores).
  • send_email Envía un correo, solo si la persona aceptó recibirlo.
  • deliver_response Responde una conversación por su mismo canal.
  • get_conversation Una conversación con sus últimos mensajes.
  • get_status Quién llama, el plan del negocio y si está activo.
  • get_usage Mensajes usados este mes frente al plan.
  • list_plans Los planes y sus límites.
  • upgrade_plan Un enlace de pago para que lo apruebe el dueño. Los agentes nunca pagan.
  • make_call Llamar a un cliente. Aún no disponible.

4. Cuando la respuesta es no

Un rechazo es un código simple con un mensaje en inglés y español. No se envió nada.

  • consent_required La persona no aceptó este tipo de mensaje por este canal. No se envió nada.
  • opted_out La persona respondió STOP. No se envió nada.
  • outside_window La persona escribió hace más de 24 horas, así que ahora no se puede responder ahí.
  • template_required_outside_session En WhatsApp, después de 24 horas solo puede ir una plantilla aprobada. Envía un mensaje de texto.
  • compliance_blocked El mensaje no pasó la revisión (por ejemplo, datos personales). No se envió nada.
  • payment_required El negocio necesita un plan activo. El dueño aprueba el enlace.
  • quota_exceeded El negocio usó todos los mensajes de su plan.
  • calls_not_available Las llamadas aún no están disponibles.

Cuando un negocio está apagado o pasó su plan:

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

Inicio de sesión para agentes

El inicio de sesión de un agente en nombre del dueño aún no está activado. Por ahora usa la clave del negocio.

CelVak para desarrolladoresInicio de talkvak