Overview

Presence indicates that a system is receiving and processing events for a merchant. It can be a server, a web page or an application. Each event delivery method (polling or webhook) shows presence differently.Presence ensures that the merchant is able to receive orders in real time. The system considers a merchant online when it detects that they are receiving events. This reduces cancellations due to lack of response and improves user experience. To appear as open in the app, the merchant must meet criteria such as operating hours, published menu and active presence on the platform.Today, we consider the merchant online when:

The system polls events for them, or
The server receives events via webhook successfully.

Presence is equivalent to the "online" status in messaging applications.This page aims to explain a bit about the concept of presence in iFood and how presence is related to event delivery in iFood.

Heartbeat

We use heartbeats for delivery mechanisms without persistent connection (polling or webhook). Heartbeats are periodic messages that confirm the active presence of the system listening for events.In polling, each request generates a heartbeat for the merchants authorized in the token or in the x-polling-merchants header.In webhook, we send periodic requests to check the server status and ensure active presence per merchant.

Learn more here about how the concept of presence works in webhook.

Was this page helpful?

Rate your experience in the new Developer portal:

On this page

Overview

Heartbeat

Content read0%