piece-osvi-ai
v0.0.6
Published
Activepieces piece for Osvi AI, an AI phone calling platform for outbound voice agents.
Readme
Osvi AI Activepieces Piece
Activepieces piece for Osvi AI, an AI phone calling platform for outbound voice agents.
Package
piece-osvi-aiFeatures
- Load active Osvi agents from
GET https://api.osvi.ai/v1/active_agents - Trigger outbound phone calls with
POST https://api.osvi.ai/call - Pass call context such as person name, initial greeting, language, and additional mapped data
- Send
system_promptas an empty string in the call request - Send a user-provided
webhook_url, orhttps://example.com/osvi-ai/webhookwhen the webhook URL is left blank - Use the custom API call action for advanced Osvi API requests
Authentication
This piece uses an Osvi API token. The token is sent with each request using the API-Token header.
The connection test validates the token by calling:
GET https://api.osvi.ai/v1/active_agentsActions
Make Call
Triggers an Osvi agent to place an outbound call.
Inputs:
- Agent: selected from active Osvi agents
- Phone Number
- Country Code
- Language
- Person Name
- Initial Greeting
- Webhook URL
- Additional Data
The selected agent is mapped internally to the request body as agent_uuid. The call request also sends system_prompt as an empty string and sends webhook_url with either the user-provided value or the dummy default URL.
Local Development
From the Activepieces repository root:
bun install
npx turbo run build --filter=piece-osvi-ai
npx turbo run lint --filter=piece-osvi-aiTo package the piece:
NPM_CONFIG_CACHE=/private/tmp/activepieces-npm-cache npm run build-piece -- osvi-aiThe generated tarball is written to:
packages/pieces/community/osvi-ai/dist/piece-osvi-ai-0.0.6.tgzPublishing to npm
Login to npm:
npm loginPublish the generated package:
npm publish packages/pieces/community/osvi-ai/dist/piece-osvi-ai-0.0.6.tgz --access publicLogo
For local Activepieces development, the piece currently uses:
/pieces/osvi-ai.svgFor a package shared across other Activepieces instances, use a public logo URL that returns CORS headers, including:
Access-Control-Allow-Origin: *