Remote Join

The "Remote Join" feature allows customers to get their ticket from home or while on the move, then physically join the service before their turn.

How It Works

1. Remote ticket taking: Customer gets a ticket from the mobile app
2. Real-time tracking: System tracks their position and calculates travel time
3. Notifications: Customer receives alerts to leave at the right time
4. Presence validation: Customer must be within the service perimeter before being called

Check Eligibility

Before joining a queue remotely, verify if the customer meets the conditions.

POST /v1/queues/{queueId}/eligibility
X-API-Key: your_api_key_here
Content-Type: application/json

{
  "latitude": 6.3702,
  "longitude": 2.3912
}

Join a Queue Remotely

POST /v1/remote-join/{queueId}/start
X-API-Key: your_api_key_here
Content-Type: application/json

{
  "latitude": 6.3702,
  "longitude": 2.3912
}

Remote Join Statuses

Update Position

Customer must send regular position updates to track progress and validate geofence entry.

POST /v1/remote-join/{ticketId}/location
X-API-Key: your_api_key_here
Content-Type: application/json

{
  "latitude": 6.3680,
  "longitude": 2.3925,
  "accuracy": 10
}

Confirm Presence

When the customer has arrived (usually within the geofence perimeter), they must confirm their presence to be eligible for calling.

POST /v1/remote-join/{ticketId}/confirm
X-API-Key: your_api_key_here
Content-Type: application/json

{
  "method": "geofence"
}

Service Configuration

Services can configure the maximum radius for remote ticket taking.

Anti-Abuse System

Oquira integrates an abuse detection system:

• Warnings: Progressive warnings for no-shows
• Penalties: Temporary restrictions after multiple infractions
• Suspicion score: User behavior tracking

Important: Customers who abuse the remote join system may have their access temporarily restricted.