webex-byova 0.1.0

Python SDK for Webex Contact Center BYOVA / BYODS — Data Sources, Service App tokens, and Integration OAuth

webex-byova

Python SDK for Webex Contact Center BYOVA and the foundational Bring Your Own Data Source (BYODS) APIs.

Simplify Service App token management, Integration OAuth, DataSource CRUD, schema discovery, and JWS verification.

Install

pip install webex-byova

Quick start

import asyncio
from webex_byova import BYOVA
from webex_byova.models import IntegrationCredentials, ServiceAppCredentials

sdk = BYOVA(
    integration=IntegrationCredentials(
        client_id="YOUR_INTEGRATION_CLIENT_ID",
        client_secret="YOUR_INTEGRATION_CLIENT_SECRET",
        redirect_uri="http://127.0.0.1:8765/callback",
    ),
    service_app=ServiceAppCredentials(
        client_id="YOUR_SERVICE_APP_CLIENT_ID",
        client_secret="YOUR_SERVICE_APP_CLIENT_SECRET",
    ),
)

async def main():
  # Developer authorizes Integration (not customer admin)
  await sdk.integration.aauthorize(
      scopes=[
          "spark:applications_token",
          "application:webhooks_write",
          "application:webhooks_read",
      ],
      open_browser=True,
  )

  await sdk.webhooks.aensure_service_app_webhooks(
      target_url="https://your-app.example.com/webhooks/webex",
  )

asyncio.run(main())

After a customer admin authorizes your Service App in Control Hub, handle the webhook:

result = await sdk.ahandle_service_app_webhook(webhook_json)
client = await sdk.aget_client_for_org(result.org_id)
sources = await client.data_sources.alist()

Environment variables

export WEBEX_INTEGRATION_CLIENT_ID=...
export WEBEX_INTEGRATION_CLIENT_SECRET=...
export WEBEX_SA_CLIENT_ID=...
export WEBEX_SA_CLIENT_SECRET=...
export WEBEX_INTEGRATION_REDIRECT_URI=http://127.0.0.1:8765/callback

sdk = BYOVA.from_env()

Documentation

See the docs/ directory and CONTRIBUTING.md.

License

MIT — see LICENSE.