{"id":28746185,"url":"https://github.com/webex/datasourceschemas","last_synced_at":"2026-06-09T06:06:03.452Z","repository":{"id":265231014,"uuid":"778460527","full_name":"webex/dataSourceSchemas","owner":"webex","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-11T12:36:58.000Z","size":168,"stargazers_count":2,"open_issues_count":4,"forks_count":5,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-05-11T14:34:21.197Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-03-27T19:12:07.000Z","updated_at":"2026-05-11T12:37:03.000Z","dependencies_parsed_at":"2025-07-31T14:35:04.459Z","dependency_job_id":"004f4f04-a76e-4c30-92de-5e04fc002813","html_url":"https://github.com/webex/dataSourceSchemas","commit_stats":null,"previous_names":["webex/datasourceschemas"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/webex/dataSourceSchemas","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webex%2FdataSourceSchemas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webex%2FdataSourceSchemas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webex%2FdataSourceSchemas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webex%2FdataSourceSchemas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webex","download_url":"https://codeload.github.com/webex/dataSourceSchemas/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webex%2FdataSourceSchemas/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34093797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-16T14:30:40.012Z","updated_at":"2026-06-09T06:06:03.430Z","avatar_url":"https://github.com/webex.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# About\nThis repository includes schema definitions, used while creating BYoDS service apps. There is a unique schema for each use case.\nSchema definition is nothing but a defined structure which includes payload and other information for a specific use case.These schema definitions are defined and published by Webex teams so that partners/customers can build their side of solutions leveraging the defined format.\nFor example Voice virtual agent schema incldues the structure information of voice virtual agent use case. Which is used by contact center platform and partners/customers to build solution.\nDevelopers need to go to respective service folder, go through the schema definitions to validate if it matches their use case. If not new schema deifnition has to be created and approved by webex teams, matching your use case.\nTo know more about the BYoDS framework, please refer our developer portal-\nhttps://developer.webex.com/create/docs/bring-your-own-datasource\n\n# Supported use-cases\n## Voice Virtual Agent \nPlease refer voiceVirtualAgent schema definition to build the solution for BYoVA on top of webex contact center.\n## Media forking\nPlease refer mediaForking schema definition to build the solution for media forking on top of webex contact center.\n\n# Schema structure\n## Schema defintion location\nSchema defintion of each use case is defined as per below folder structure-\nServices-\u003eschema name-\u003eschema id-\u003eschema.json\n**Example** - Path of voice virtual agent schema is Services/VoiceVirtualAgent/5397013b-7920-4ffc-807c-e8a3e0a18f43/schema.json\n\n## Fields in schema defintion\n**Schema name** - Name of the defined schema.\n**Schema id** - Unique id(uuid) assigned to the schema.\n**Protocol** - gRPC or REST\n**Payload** - version(version of the payload),requestSchema(request payload structure) and responseSchema(response payload structure).\n**SupportedAppType** - serviceApp or bot\n\n**Example** -\nVoice virtual agent schema definition\n```\n{\n    \"schemaId\": \"5397013b-7920-4ffc-807c-e8a3e0a18f43\",\n    \"serviceName\": \"Voice Virtual Agent Service\",\n    \"protocol\": \"gRPC\",\n    \"payload\": {\n        \"version\": \"1.0\",\n        \"requestSchema\": {\n            \"uri\": \"https://github.com/webex/dataSourceSchemas/blob/v1.8/Services/VoiceVirtualAgent/5397013b-7920-4ffc-807c-e8a3e0a18f43/Proto/voicevirtualagent.proto\"\n        },\n        \"responseSchema\": {\n            \"uri\": \"https://github.com/webex/dataSourceSchemas/blob/v1.8/Services/VoiceVirtualAgent/5397013b-7920-4ffc-807c-e8a3e0a18f43/Proto/voicevirtualagent.proto\"\n        }\n    },\n    \"supportedAppType\": \"serviceApp\"\n}\n```\n**Proto definitions**-\nServices-\u003eVoiceVirtualAgent-\u003e5397013b-7920-4ffc-807c-e8a3e0a18f43-\u003eProto\nServices-\u003eVoiceVirtualAgent-\u003e5397013b-7920-4ffc-807c-e8a3e0a18f43-\u003eProto-\u003eDocs\n\n## General guidelines for schema\n1. requestSchema and responseSchema need to point to defined payload files(path needs to be mentioned in uri).\n2. For gRPC request and response payload will be in the form of Proto files and for REST, it will be JSON.\n3. Documenation of the request and response proto files should be given in Services-\u003eschema name-\u003e Proto-\u003eDocs in the form of md files for gRPC.\n4. Documenation of the request and response JSON files should be given in Services-\u003eschema name-\u003e JSON -\u003eDocs in the form of API spec for REST.\n5. Payloads should be backward compatible. This means newer version should be backward compatible.\n\n# Contribution\nThis repository is a read-only repository and will be used only to read the existing schema defintions and supported files.\nSchema defintions can only be published by webex internal teams.\n\n# Git versioning and new release\nWhenever new changes are published to this branch, a new relase tag will be generated and the changes will be reflected in latest release tag.\nChanges done for a specific release tag will be mentioned in notes.\n\n# Issues\nhttps://developer.webex.com/support\ndevsupport@webex.com\nMaintainers\n\nThis project is maintained by Cisco Webex for Developers.\n\n# glossary\n**BYoDS** - Bring your own Data Source - https://developer.webex.com/create/docs/bring-your-own-datasource\n**BYoVA** - Bring your own virtual agent - https://developer.webex.com/webex-contact-center/docs/bring-your-own-virtual-agent\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebex%2Fdatasourceschemas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebex%2Fdatasourceschemas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebex%2Fdatasourceschemas/lists"}