Empezar
Cómo conectar
Elige por dónde entras y haz tu primera llamada.
Las tres puertas dan al mismo sitio. La diferencia es dónde vive tu código.
Tu asistente. Autoservicio, sin código, dos minutos.
Tu backend. Una clave, curl, y ya.
Tus automatizaciones. OAuth, sin clave que guardar.
MCP — conectar un asistente
Nadie en Orkasa registra tu aplicación: el descubrimiento y el registro son automáticos (RFC 9728 y RFC 7591).
Añade el conector
En Claude: Configuración → Conectores → Añadir conector personalizado. Pega la dirección:
https://orkasa.app/api/mcp
Autoriza
Se abre Orkasa, entras con tu cuenta de siempre y apruebas los permisos. Cada permiso se puede desmarcar; el asistente solo verá lo que dejes marcado.
Pregunta
« ¿Qué tengo hoy? » · « ¿Cómo va lo de Felipe? » · « Agenda la visita del jueves a las 4 con Ana en el apartamento de El Cangrejo. »
Los detalles del flujo — y por qué el registro abierto es seguro — están en Conectar un asistente.
API — primera llamada
Las claves de API las emite Orkasa por agencia. Escríbenos desde el
formulario de contacto y te llega tu ork_live_…
con los permisos que pidas.
La clave se muestra una sola vez. De ella solo guardamos un resumen SHA-256, así que no hay forma de recuperarla: si se pierde, se revoca y se emite otra.
export ORKASA_KEY="ork_live_…"
export ORKASA_API="https://orkasa.app/api/v1"
curl "$ORKASA_API/me" -H "Authorization: Bearer $ORKASA_KEY"{
"brokerage_id": "0d1f…",
"brokerage_name": "Casa Móvil Panamá",
"scopes": ["leads:read", "leads:write", "operations:read"]
}GET /me es la única respuesta plana de la API: no lleva envoltorio data,
porque Zapier la usa tal cual para etiquetar la conexión. Todo lo demás sigue el
envoltorio estándar.
Ahora crea un lead — un contacto, un lead y su operación abierta, en una llamada:
curl -X POST "$ORKASA_API/leads" \
-H "Authorization: Bearer $ORKASA_KEY" \
-H "Content-Type: application/json" \
-d '{
"full_name": "Ana Torrijos",
"phone": "+507 6123 4567",
"origin": "web",
"budget_max": 250000,
"bedrooms_min": 2,
"operation_type": "buy"
}'El operation_id que devuelve es el hilo del que cuelga todo lo demás. Sigue en
De lead a visita.
Zapier
La aplicación de Orkasa en Zapier corre sobre esta misma API, con OAuth en lugar de clave: autorizas una vez y Zapier renueva su acceso solo.
Trae Create Lead como acción, Find Lead como búsqueda, y cinco disparadores — entre ellos los cuatro webhooks de cambio de estado.
Un Zap típico de entrada: Gmail — correo nuevo en la bandeja de la agencia →
Orkasa — Create Lead con origin: "email" y el cuerpo del correo en
email_body. El lead entra ya calificado por la IA.