# @or-sdk/bots

> OneReach SDK client for Bots

Latest version **1.9.3** (published 2026-10-29) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @or-sdk/bots
pnpm add @or-sdk/bots
yarn add @or-sdk/bots
bun add @or-sdk/bots
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.9.3 |
| Published | 2026-10-29 |
| First published | 2021-11-23 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 80.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | onereach.admin, user.npm |

## Links

- npm: https://www.npmjs.com/package/@or-sdk/bots
- npm.io page: https://npm.io/package/@or-sdk/bots

## Dependencies (4)

- [@or-sdk/base](https://npm.io/package/@or-sdk/base.md) ^0.45.3
- [@or-sdk/tags](https://npm.io/package/@or-sdk/tags.md) ^1.3.3
- [browser-or-node](https://npm.io/package/browser-or-node.md) 3.0.0
- [@or-sdk/data-hub-svc](https://npm.io/package/@or-sdk/data-hub-svc.md) ^2.5.3

## Recent versions

- 1.9.3 (latest) — 2026-10-29
- 1.9.3-beta.4425.0 (beta) — 2026-10-29
- 0.25.7-next.697.0 (next) — 2022-10-21
- 1.9.3-beta.4421.0 — 2026-10-28
- 1.9.2 — 2026-09-25
- 1.9.2-beta.4380.0 — 2026-09-25
- 1.9.1 — 2026-09-21
- 1.9.1-beta.4364.0 — 2026-09-21
- 1.9.1-beta.4362.0 — 2026-09-21
- 1.9.0 — 2026-08-05
- 1.8.1-beta.4286.0 — 2026-08-05
- 1.8.1-beta.4283.0 — 2026-08-05
- 1.8.1-beta.4282.0 — 2026-08-05
- 1.8.0 — 2026-08-05
- 1.7.6-beta.4276.0 — 2026-08-05
- … 483 more at https://npm.io/package/@or-sdk/bots/versions

## README

# `@or-sdk/bots`

OneReach SDK client for Bots.

## When to use

- Use this package when integrating with the Bots capability on the OneReach platform.
- Use its typed client and exported models instead of hand-writing requests to that service.

## When not to use

- Do not use it for a different platform capability; choose the dedicated `@or-sdk/*` package instead.
- Do not use it for generic third-party HTTP calls.

## Installation
```
$ npm i @or-sdk/bots
```

## Usage
```typescript
import { Bots } from '@or-sdk/bots'

// with direct api url
const bots = new Bots({
  token: 'my-account-token-string',
  dataHubSvcUrl: 'http://example.data-hub-svc/endpoint'
});

// with service discovery(slower)
const bots = new Bots({
  token: 'my-account-token-string',
  discoveryUrl: 'http://example.discovery/endpoint'
});
 ```

## Configuration

- Prefer `dataHubSvcUrl` when the service URL is known; it avoids a discovery request.
- Use `discoveryUrl` only when the service URL is not available.
- Provide `token` as a bearer-token string or getter where supported.

## Common pitfalls

- Keep the client token current when it can expire; a token getter is preferable where the constructor accepts one.
- Treat the generated TypeScript types as the authoritative contract for optional parameters and response shapes.

## Method map

| Method | Purpose |
|---|---|
| `listBots(...)` | See the exported TypeScript signature for parameters and result. |
| `getBot(...)` | See the exported TypeScript signature for parameters and result. |
| `saveBot(...)` | See the exported TypeScript signature for parameters and result. |
| `deleteBot(...)` | See the exported TypeScript signature for parameters and result. |
| `recoverBot(...)` | See the exported TypeScript signature for parameters and result. |
| `downloadTemplate(...)` | See the exported TypeScript signature for parameters and result. |
| `addTags(...)` | See the exported TypeScript signature for parameters and result. |
| `removeTags(...)` | See the exported TypeScript signature for parameters and result. |
| `uploaderBotImage(...)` | See the exported TypeScript signature for parameters and result. |
| `resolve(...)` | See the exported TypeScript signature for parameters and result. |
| `listBotCategories(...)` | See the exported TypeScript signature for parameters and result. |

## More detail

Full signatures and exported types are available in `src/` and `dist/types/`.

---
_Source: https://npm.io/package/@or-sdk/bots · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
