Developer Portal

Integra el Agente Virtual de Phylax en tu CRM inmobiliario. Gestiona sucursales, propiedades, leads y créditos desde tu propia plataforma.

# 1. Crear una sucursal
curl -X POST https://api.phylax-ia.com/api/v1/orgs \
  -H "Authorization: Bearer <ENTERPRISE_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sucursal Centro","slug":"sucursal-centro","branchId":"SCENTRO"}'

# 2. Cargar una propiedad
curl -X POST https://api.phylax-ia.com/api/v1/properties \
  -H "Authorization: Bearer <ORG_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "prop-001",
    "title": "Apartamento 2 dorm en Pocitos",
    "type": "apartment",
    "operation": "rent",
    "price": 900,
    "currency": "USD",
    "bedrooms": 2,
    "bathrooms": 1,
    "area": 72,
    "address": "Pocitos, Montevideo",
    "description": "Luminoso, piso 5, con terraza."
  }'

Authorization: Bearer <API_KEY>

https://api.phylax-ia.com/api/v1

curl -X POST https://api.phylax-ia.com/api/v1/orgs \
  -H "Authorization: Bearer <ENTERPRISE_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name":     "Sucursal Carrasco",
    "slug":     "sucursal-carrasco",
    "branchId": "CARR001"
  }'

{
  "ok": true,
  "org": {
    "_id":      "6631a2b3c4d5e6f7a8b9c0d1",
    "name":     "Sucursal Carrasco",
    "slug":     "sucursal-carrasco",
    "branchId": "CARR001",
    "status":   "active",
    "credits":  { "balance": 15, "reserved": 0 }
  },
  "apiKey": "pk_org_xxxxxxxxxxxxxxxxxxxxxxxx"
}

curl https://api.phylax-ia.com/api/v1/orgs/CARR001 \
  -H "Authorization: Bearer <ORG_KEY>"

curl -X POST https://api.phylax-ia.com/api/v1/properties \
  -H "Authorization: Bearer <ORG_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId":  "apt-pocitos-001",
    "title":       "Apartamento 2 dormitorios en Pocitos",
    "type":        "apartment",
    "operation":   "rent",
    "price":       900,
    "currency":    "USD",
    "bedrooms":    2,
    "bathrooms":   1,
    "area":        72,
    "address":     "Pocitos, Montevideo",
    "description": "Luminoso, piso 5 con terraza y vista al mar.",
    "features":    ["terraza","amoblado","luminoso"]
  }'

curl "https://api.phylax-ia.com/api/v1/customers?page=1&limit=50&from=2026-05-01" \
  -H "Authorization: Bearer <ORG_KEY>"

{
  "ok":      true,
  "total":   142,
  "page":    1,
  "customers": [
    {
      "_id":       "6631a2b3c4d5e6f7a8b9c0d2",
      "firstName": "Martín",
      "lastName":  "García",
      "phone":     "+59899123456",
      "email":     "martin@email.com",
      "botMode":   "auto",
      "createdAt": "2026-05-01T14:22:10.000Z"
    }
  ]
}

curl "https://api.phylax-ia.com/api/v1/conversations?limit=20" \
  -H "Authorization: Bearer <ORG_KEY>"

# Tomar una escalación
curl -X POST https://api.phylax-ia.com/api/v1/escalations/6631a2b3.../accept \
  -H "Authorization: Bearer <ORG_KEY>"

# Liberar y devolver control al agente virtual
curl -X POST https://api.phylax-ia.com/api/v1/escalations/6631a2b3.../release \
  -H "Authorization: Bearer <ORG_KEY>"

{
  "ok": true,
  "credits": {
    "balance":  12,
    "reserved":  8,
    "available": 4,
    "cycle_ends": "2026-06-01T00:00:00.000Z"
  }
}

curl -X POST https://api.phylax-ia.com/api/v1/credits/recharge \
  -H "Authorization: Bearer <ORG_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"pack":"M","payment_ref":"ch_test_xxxxxxxxxxxxxxxx"}'

const crypto = require('crypto');

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// En Express:
app.post('/webhook/phylax', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-phylax-signature'];
  if (!verifyWebhook(req.body, sig, process.env.PHYLAX_WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  const event = JSON.parse(req.body);
  // Procesar event.type y event.data...
  res.sendStatus(200);
});

{
  "event":     "customer.created",
  "branch_id": "CARR001",
  "timestamp": "2026-05-01T15:30:00.000Z",
  "data": {
    "customer_id": "6631a2b3c4d5e6f7a8b9c0d2",
    "firstName":   "Martín",
    "lastName":    "García",
    "phone":       "+59899123456",
    "source":      "whatsapp"
  }
}

{
  "ok":    false,
  "error": "Crédito insuficiente para activar la propiedad"
}