Oquira BusinessIntégrez la gestion de files d'attente Oquira directement sur votre site web.
Le widget Oquira vous permet d'intégrer la prise de ticket et l'affichage de l'état des files d'attente directement sur votre site web, sans que vos visiteurs aient besoin de télécharger l'application.
| Type | Description | Cas d'usage |
|---|---|---|
| Queue Status | Affiche le nombre de personnes en attente | Informer avant déplacement |
| Join Queue | Permet de prendre un ticket | Prise de ticket en ligne |
| Display Board | Écran d'appel pour salle d'attente | Affichage sur écran TV |
Obtenez les informations nécessaires pour afficher un widget.
GET /v1/widget/organization/{organizationId}/info
X-API-Key: votre_cle_apiEndpoint public pour afficher l'état d'une file sans authentification.
GET /v1/widget/queue/{queueId}/statusPermet aux visiteurs web de prendre un ticket.
POST /v1/widget/queue/{queueId}/join
X-API-Key: votre_cle_api
Content-Type: application/json
{
"visitorName": "Jean Dupont",
"phone": "+33612345678",
"partySize": 1
}| Propriété | Type | Requis | Description |
|---|---|---|---|
visitorName | string | Non | Nom du visiteur |
phone | string | Non | Téléphone pour notifications |
partySize | number | Non | Nombre de personnes |
Endpoint optimisé pour les écrans d'affichage en salle d'attente.
GET /v1/widget/organization/{organizationId}/display-board
X-API-Key: votre_cle_api<!-- Widget Oquira -->
<div
id="oquira-widget"
data-organization="org_xyz..."
data-queue="que_123..."
></div>
<script src="https://widget.oquira.com/v1/embed.js" async></script>window.OquiraWidget = {
organizationId: "org_xyz...",
queueId: "que_123...",
theme: "light", // ou 'dark'
language: "fr", // ou 'en'
showEstimatedWait: true,
allowJoin: true,
onTicketCreated: function (ticket) {
console.log("Ticket créé:", ticket.displayCode);
},
};Connectez-vous au WebSocket pour des mises à jour en temps réel.
const ws = new WebSocket("wss://api.oquira.com/v1/widget/ws");
ws.on("message", (data) => {
const event = JSON.parse(data);
if (event.type === "queue_update") {
updateQueueDisplay(event.data);
}
});
// S'abonner à une file
ws.send(
JSON.stringify({
action: "subscribe",
queueId: "que_123...",
}),
);| Option | Description |
|---|---|
theme | light ou dark |
primaryColor | Couleur principale (hex) |
language | fr ou en |
showLogo | Afficher le logo de l'organisation |
compact | Mode compact pour petits espaces |