Overview
Overview: Create an inbox backed by your own system (app, IoT, marketplace) using OXVO’s Channel API.
Where to set it up: Dashboard → Connections → Channels → select the channel → Connect.
How it works
Your system sends inbound messages to OXVO via API/webhook endpoints.
OXVO delivers agent replies back to your system using callback URLs or polling.
You control identity mapping, attachments, and message metadata.
Configure - implementation details
Create a custom API channel
Go to Dashboard → Connections → Channels → API and click Connect.
Name the channel and generate an API token/secret for your integration.
Implement inbound messaging by calling the OXVO Channel API endpoints with your token.
Configure your outbound delivery method (webhook callback URL or polling) so your system can receive agent replies.
Test with a single conversation before rolling out to production, and add rate limiting and retries in your integration.
Recommended: Include a stable external user ID in every message so OXVO can correctly map contacts across sessions.
![](data:image/svg+xml,<svg display="block" role="presentation" viewBox="0 0 40 40" xmlns="http://www.w3.org/2000/svg"><g d="M 11.425 22.862 L 10 22.862 C 9.622 22.865 9.26 23.013 8.987 23.275 C 8.723 23.546 8.575 23.909 8.575 24.287 L 8.575 26.787 L 12.862 26.787 L 12.862 24.287 C 12.863 23.907 12.711 23.543 12.441 23.275 C 12.171 23.008 11.805 22.859 11.425 22.862 Z M 40 12.863 L 40 34.288 C 39.993 37.44 37.44 39.993 34.288 40 L 5.712 40 C 2.56 39.993 0.007 37.44 0 34.288 L 0 12.863 Z M 15.713 24.287 C 15.719 23.148 15.27 22.054 14.464 21.248 C 13.659 20.443 12.564 19.993 11.425 20 L 10 20 C 7.632 20 5.713 21.92 5.713 24.287 L 5.713 31.425 C 5.662 31.968 5.923 32.493 6.387 32.781 C 6.85 33.068 7.437 33.068 7.901 32.781 C 8.365 32.493 8.626 31.968 8.575 31.425 L 8.575 29.7 L 12.863 29.7 L 12.863 31.425 C 12.863 32.212 13.5 32.85 14.288 32.85 C 15.075 32.85 15.713 32.212 15.713 31.425 Z M 28.75 24.288 C 28.757 23.153 28.311 22.062 27.51 21.257 C 26.71 20.452 25.622 20 24.487 20 L 20 20 C 19.213 20 18.575 20.638 18.575 21.425 L 18.575 31.425 C 18.575 32.212 19.213 32.85 20 32.85 C 20.787 32.85 21.425 32.212 21.425 31.425 L 21.425 29.7 L 24.462 29.7 C 26.83 29.7 28.75 27.78 28.75 25.413 Z M 34.262 21.425 C 34.193 20.686 33.573 20.121 32.831 20.121 C 32.089 20.121 31.469 20.686 31.4 21.425 L 31.4 31.425 C 31.349 31.968 31.61 32.493 32.074 32.781 C 32.538 33.068 33.125 33.068 33.588 32.781 C 34.052 32.493 34.313 31.968 34.262 31.425 Z M 0 10 L 0 5.713 C 0.007 2.56 2.56 0.007 5.712 0 L 34.288 0 C 37.44 0.007 39.993 2.56 40 5.713 L 40 10 Z M 11.847 4.7 C 11.577 4.968 11.425 5.332 11.425 5.713 C 11.425 6.498 12.061 7.135 12.846 7.137 C 13.631 7.14 14.27 6.506 14.275 5.721 C 14.28 4.935 13.648 4.294 12.863 4.288 C 12.482 4.284 12.117 4.433 11.847 4.7 Z M 5.713 5.712 C 5.713 6.5 6.35 7.137 7.138 7.137 C 7.925 7.137 8.563 6.5 8.563 5.712 C 8.563 4.925 7.925 4.287 7.138 4.287 C 6.35 4.287 5.713 4.925 5.713 5.712 Z M 24.488 22.862 L 21.425 22.862 L 21.425 26.837 L 24.488 26.837 C 25.275 26.837 25.913 26.2 25.913 25.412 L 25.913 24.287 C 25.916 23.909 25.767 23.544 25.499 23.276 C 25.231 23.008 24.866 22.859 24.488 22.862 Z" fill="transparent" height="40.00000019073485px" id="aiNGmZR6p" width="40px"><path d="M 2.85 0 L 1.425 0 C 1.047 0.003 0.685 0.15 0.413 0.413 C 0.148 0.683 0 1.047 0 1.425 L 0 3.925 L 4.287 3.925 L 4.287 1.425 C 4.288 1.045 4.136 0.681 3.866 0.413 C 3.596 0.145 3.23 -0.003 2.85 0 Z" fill="rgb(0, 0, 0)" height="3.9250549017688456px" id="xGb57ahfJ" transform="translate(8.575 22.862)" width="4.2875000010562445px"/><path d="M 40 12.863 L 40 34.288 C 39.993 37.44 37.44 39.993 34.288 40 L 5.712 40 C 2.56 39.993 0.007 37.44 0 34.288 L 0 12.863 Z M 15.713 24.287 C 15.719 23.148 15.27 22.054 14.464 21.248 C 13.659 20.443 12.564 19.993 11.425 20 L 10 20 C 7.632 20 5.713 21.92 5.713 24.287 L 5.713 31.425 C 5.662 31.968 5.923 32.493 6.387 32.781 C 6.85 33.068 7.437 33.068 7.901 32.781 C 8.365 32.493 8.626 31.968 8.575 31.425 L 8.575 29.7 L 12.863 29.7 L 12.863 31.425 C 12.863 32.212 13.5 32.85 14.288 32.85 C 15.075 32.85 15.713 32.212 15.713 31.425 Z M 28.75 24.288 C 28.757 23.153 28.311 22.062 27.51 21.257 C 26.71 20.452 25.622 20 24.487 20 L 20 20 C 19.213 20 18.575 20.638 18.575 21.425 L 18.575 31.425 C 18.575 32.212 19.213 32.85 20 32.85 C 20.787 32.85 21.425 32.212 21.425 31.425 L 21.425 29.7 L 24.462 29.7 C 26.83 29.7 28.75 27.78 28.75 25.413 Z M 34.262 21.425 C 34.193 20.686 33.573 20.121 32.831 20.121 C 32.089 20.121 31.469 20.686 31.4 21.425 L 31.4 31.425 C 31.349 31.968 31.61 32.493 32.074 32.781 C 32.538 33.068 33.125 33.068 33.588 32.781 C 34.052 32.493 34.313 31.968 34.262 31.425 Z M 0 10 L 0 5.713 C 0.007 2.56 2.56 0.007 5.712 0 L 34.288 0 C 37.44 0.007 39.993 2.56 40 5.713 L 40 10 Z M 11.847 4.7 C 11.577 4.968 11.425 5.332 11.425 5.713 C 11.425 6.498 12.061 7.135 12.846 7.137 C 13.631 7.14 14.27 6.506 14.275 5.721 C 14.28 4.935 13.648 4.294 12.863 4.288 C 12.482 4.284 12.117 4.433 11.847 4.7 Z M 5.713 5.712 C 5.713 6.5 6.35 7.137 7.138 7.137 C 7.925 7.137 8.563 6.5 8.563 5.712 C 8.563 4.925 7.925 4.287 7.138 4.287 C 6.35 4.287 5.713 4.925 5.713 5.712 Z" fill="rgb(0, 0, 0)" height="40.00000019073485px" id="WGMMcZ7xV" width="40px"/><path d="M 3.063 0 L 0 0 L 0 3.975 L 3.063 3.975 C 3.85 3.975 4.488 3.337 4.488 2.55 L 4.488 1.425 C 4.491 1.046 4.342 0.682 4.074 0.414 C 3.806 0.146 3.441 -0.003 3.063 0 Z" fill="rgb(0, 0, 0)" height="3.975055885016161px" id="jOMWvqVD_" transform="translate(21.425 22.862)" width="4.487555885016178px"/></g></svg>)
