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_textEnvía un mensaje de texto desde la línea del negocio, solo si la persona aceptó recibirlo.send_whatsappEnvía un WhatsApp, solo si la persona aceptó (plan Pro y superiores).send_emailEnvía un correo, solo si la persona aceptó recibirlo.deliver_responseResponde una conversación por su mismo canal.get_conversationUna conversación con sus últimos mensajes.get_statusQuién llama, el plan del negocio y si está activo.get_usageMensajes usados este mes frente al plan.list_plansLos planes y sus límites.upgrade_planUn enlace de pago para que lo apruebe el dueño. Los agentes nunca pagan.make_callLlamar 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_requiredLa persona no aceptó este tipo de mensaje por este canal. No se envió nada.opted_outLa persona respondió STOP. No se envió nada.outside_windowLa persona escribió hace más de 24 horas, así que ahora no se puede responder ahí.template_required_outside_sessionEn WhatsApp, después de 24 horas solo puede ir una plantilla aprobada. Envía un mensaje de texto.compliance_blockedEl mensaje no pasó la revisión (por ejemplo, datos personales). No se envió nada.payment_requiredEl negocio necesita un plan activo. El dueño aprueba el enlace.quota_exceededEl negocio usó todos los mensajes de su plan.calls_not_availableLas 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.