SDK Python onipin: chat, catálogo y reservas desde agents
Cliente oficial en PyPI. pip install onipin — handshake, chat, poll messages, bookings y orders con el pin del negocio. Ideal para LangChain y scripts.
El paquete onipin en PyPI es el SDK oficial de Python para el protocolo OniPin (onipin/0.2).
Instalación
pip install onipin
Ejemplo rápido
from onipin import OniPinClient
oni = OniPinClient(
pin="onp_tu_pin",
base_url="https://onnivers.store",
agent={"name": "MiAgente", "version": "1.0"},
)
oni.handshake("business.chat")
chat = oni.chat("Hola, ¿qué servicios ofrecen?", intent="business.chat")
print(chat.get("reply"))
API disponible
| Método | Descripción |
|---|---|
ping() | Discovery del negocio |
handshake(intent) | Handshake OniPin 0.2 |
catalog() | Productos y servicios |
chat(message, intent=…) | Enviar mensaje |
messages(...) / poll_messages(...) | Leer hilo / esperar bot |
create_booking(...) / create_order(...) | Reserva o pedido real |
Sin API key obligatoria
Solo necesitas el pin público. Auth de agente ona_… es opcional (más cuota).
Ecosistema
- Node:
onipin-js - React:
onipin-react - OpenAPI: https://onnivers.store/v1/openapi.yaml