Desarrolladores

Construye con OLISE

API REST, webhooks y un SDK TypeScript tipado para integrar el operador telefónico IA de OLISE en tu CRM, tu flujo de reservas o tu stack de operaciones.

Spec OpenAPI 3.1 Estado de la API

cURL

curl -sS https://olise.ai/api/public/v1/contacts \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: olise_live_…' \
  -d '{"phone":"+13055551212","name":"Jane Doe"}'

Node

import { OliseClient } from '@olise/sdk'

const olise = new OliseClient(process.env.OLISE_API_KEY!)
const contact = await olise.contacts.create({
  phone: '+13055551212',
  name: 'Jane Doe',
})

Python

import os, requests

r = requests.post(
    "https://olise.ai/api/public/v1/contacts",
    headers={"X-API-Key": os.environ["OLISE_API_KEY"]},
    json={"phone": "+13055551212", "name": "Jane Doe"},
)
print(r.json())

Autenticación

Cada solicitud requiere un header X-API-Key. Genera las API keys desde Dashboard → Configuración → API keys. Las claves tienen permisos de alcance (lectura / escritura) y nunca salen del servidor.

Crea una clave con el alcance mínimo que necesitas.
Guárdala en tu entorno como OLISE_API_KEY.
Envíala en cada solicitud — nunca la expongas en el cliente.

Límites de uso

Límites por clave. Cada respuesta incluye los headers X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.

Plan	Ráfaga	Mensual
Starter	10 req/s	50,000 / mo
Growth	50 req/s	500,000 / mo
Enterprise	Custom	Custom

Webhooks

Suscríbete a eventos como call.completed, reservation.created, contact.updated. Los payloads están firmados con HMAC-SHA-256 en X-Olise-Signature.

Catálogo completo de eventos en la spec OpenAPI.

Endpoints

URL base: https://olise.ai/api/public

GET/v1/contactsListar contactos (cursor paginado)
POST/v1/contactsUpsert contacto por teléfono (idempotente)
GET/v1/contacts/:idObtener un contacto
PATCH/v1/contacts/:idActualizar campos
GET/v1/callsListar llamadas con filtros (intención, tiempo)
GET/v1/calls/:idObtener una llamada (transcripción redactada)
GET/v1/reservationsListar reservas
POST/v1/reservationsCrear una reserva
GET/v1/reservations/:idObtener una reserva
PATCH/v1/reservations/:idActualizar / cancelar una reserva
POST/v1/outboundDisparar una llamada saliente (Pro+)
GET/v1/usageUso y costo del período actual

SDKs oficiales

Clientes tipados para tu stack

TypeScript

@olise/sdk

Oficial. Tree-shakable. Compatible con Edge runtime.

Coming Q3 2026

Python

olise-python

Síncrono + async. Type hints. Modelos Pydantic.

Coming Q4 2026

Postman

postman_collection.json

Importa una vez y explora todos los endpoints.

Descargar