The onipin-js package is the official SDK to integrate OniPin in backends, bots, and Node.js scripts.

Installation

npm install onipin-js

Also available: React npm install onipin-react · Python pip install onipin.

Quick example

import { OniPinClient } from "onipin-js";

const oni = new OniPinClient({
  baseUrl: "https://onnivers.store",
  pin: "onp_your_pin",
  callerType: "ai-agent",
  callerName: "MyBot",
});

const info = await oni.ping();
console.log(info.name, info.capabilities);

const chat = await oni.chat("What services do you offer?");
console.log(chat.reply?.text);

Available API

Method	Description
`ping()`	Business discovery
`catalog()`	Products and services
`chat(message)`	Send a message
`messages({ limit })`	Read thread
`createBooking(...)`	Real booking
`createOrder(...)`	Real order

No API key

You only need the business public pin. Conversations appear in their CHATS inbox.

SDK documentation → · onipin-js → · onipin-react → · PyPI →