<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Thales Gaddini on Medium]]></title>
        <description><![CDATA[Stories by Thales Gaddini on Medium]]></description>
        <link>https://medium.com/@thales.gaddini?source=rss-ed9d8680d698------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*3qj9dJR49UvY6X4B.</url>
            <title>Stories by Thales Gaddini on Medium</title>
            <link>https://medium.com/@thales.gaddini?source=rss-ed9d8680d698------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Mon, 16 Nov 2026 22:38:41 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@thales.gaddini/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Webhook para parceiros iFood]]></title>
            <link>https://medium.com/ifood-developer/ifood-webhook-4f8c83a65939?source=rss-ed9d8680d698------2</link>
            <guid isPermaLink="false">https://medium.com/p/4f8c83a65939</guid>
            <category><![CDATA[webhook-integration]]></category>
            <category><![CDATA[ifood]]></category>
            <dc:creator><![CDATA[Thales Gaddini]]></dc:creator>
            <pubDate>Wed, 14 Feb 2024 19:28:01 GMT</pubDate>
            <atom:updated>2024-02-16T21:41:12.989Z</atom:updated>
            <content:encoded><![CDATA[<p>Finalmente o tão aguardado webhook de eventos de pedido do iFood será disponibilizado para as integradoras a partir do dia 19/02/2024.</p><h3>O que é o Webhook</h3><p>O webhook é um mecanismo de entrega de eventos server-server em tempo real. É a solução recomendada em situações onde a integradora tem acesso a vários merchants e faz o gerenciamento dos pedidos de forma <a href="https://developer.ifood.com.br/pt-BR/docs/guides/authentication#fluxo-de-credencial-de-aplicativo"><strong>centralizada</strong></a>. Com isso podemos evitar a limitação de múltiplos pollings para integrações com muitos merchants, evitando cenários de unauthorized durante a revogação de permissão de merchants, e também evitar o desperdício do polling contínuo (muito deles se retornar novos eventos, desperdiçando recursos).</p><p>O conceito do webhook é muito simples: ao invés das integrações fazerem requests periódicas buscando os eventos na plataforma, a integração registra uma url a ser chamada pelos nossos serviços quando nossa plataforma de eventos receber um evento de interesse da integração.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RnHO42VTkxI8cFSbnGdxSw.png" /></figure><p>Acesse nossa documentação com um <a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/overview/">overview sobre o webhook</a> e nossa documentação sobre a <a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/request/">request que nosso webhook envia</a> para saber mais.</p><h3>Configurando seu Webhook</h3><p>O processo de configuração do webhook se dá pelo developer portal do iFood na sessão “Meus apps” em uma aba específica para o gerenciamento do seu webhook. Cada app pode ter apenas um webhook configurado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/873/1*zJARAs0hlkgJWwfAssgUJA.png" /><figcaption>Configuração do webhook</figcaption></figure><p>Acesse nossa documentação para saber mais sobre o <a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/configuration/">processo de configuração</a>.</p><h3>Presença</h3><p><strong>Presença</strong> é um novo conceito que vem para as integrações junto com o webhook. Para saber mais o porque presença é importante no iFood vale a pena ler sobre <a href="https://medium.com/ifood-developer/status-de-conex%C3%A3o-dos-parceiros-no-ifood-aa010fec7713">status de conexão no iFood</a>.</p><p>Presença sempre foi um tema presente no iFood (ba-dum-tss). Esse tema só é um pouco obscuro para as integradoras pois cada request de polling hoje gera um evento de heartbeat que mantém os merchants “online” sem que a integração tenha que fazer nada além do polling de eventos.</p><p>No webhook, como os eventos são bastante espaçados, isso não é possível. Por isso são feitas requests periódicas de ping (ou keepalive) para checar o status da integração e seus merchants.</p><p>Acesse nossa documentação para saber mais sobre a <a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/presence/">request de presença</a>.</p><h3>Leitura Complementar</h3><p>Seguem links que recomendamos ler antes de começar a utilizar o webhook do iFood:</p><ul><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/presence">Presença no iFood</a></li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/overview/">Webhook no iFood</a></li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/configuration/">Configurando o webhook</a></li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/presence/">Presença no webhook</a>: o que é e como funciona</li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/request/">Request feita pelo webhook</a>: qual o formato e resposta esperada</li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/signature/">Assinatura das requests</a>: para que serve e como utilizar</li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/best-practices/">Boas práticas no webhook</a></li><li><a href="https://developer.ifood.com.br/pt-BR/docs/guides/order/events/delivery-methods/webhook/faq/">FAQ do Webhook</a></li></ul><h3>FAQ — Polling vs Webhook</h3><p>A pergunta que mais recebemos durante o piloto é se o webhook substituí o polling, e a resposta, como muitas em desenvolvimento de software, é: depende.</p><p>O webhook é um serviço totalmente independente do polling, e tem as mesmas capacidades do polling de entrega de eventos e presença. O fator determinante para decidir se a integração deve abandonar 100% o polling depende da própria integração.</p><p>Diferente do polling, o webhook não possui um mecanismo de <em>acknowledgment</em>, e embora tenha um mecanismo de <em>retry</em>, caso o envio falhe um número predeterminado de vezes definido pelo iFood, um evento pode ser descartado sem ser recebido pela integradora. Hoje não é possível recuperar estes eventos de forma automática, sendo necessário recorrer ao mecanismo de polling como fallback caso a integradora venha a ter alguma instabilidade por um período longo de tempo. Esse fluxo de fallback não precisa acontecer em paralelo do webhook e pode ser ligado conforme a necessidade da integração.</p><p>Hoje o polling e o webhook são sistemas totalmente independentes para entrega de eventos, então caso tenha interesse em utilizar o polling como fallback ou sistema de conciliação, é necessário enviar requests de acknowledgment para o sistema de polling.</p><h3>Extra — Plataforma de Eventos (Firefly)</h3><p>O webhook faz parte de nossa plataforma genérica de entrega de eventos. Deixamos o webhook compatível com o endpoint de polling de eventos de pedidos disponível no escopo de order da merchant API, mas estamos trabalhando para disponibilizar a plataforma genérica de entrega de eventos na merchant API.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4f8c83a65939" width="1" height="1" alt=""><hr><p><a href="https://medium.com/ifood-developer/ifood-webhook-4f8c83a65939">Webhook para parceiros iFood</a> was originally published in <a href="https://medium.com/ifood-developer">ifood-developer</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Status de Conexão dos Parceiros no iFood]]></title>
            <link>https://medium.com/ifood-developer/status-de-conex%C3%A3o-dos-parceiros-no-ifood-aa010fec7713?source=rss-ed9d8680d698------2</link>
            <guid isPermaLink="false">https://medium.com/p/aa010fec7713</guid>
            <category><![CDATA[api]]></category>
            <category><![CDATA[ifood]]></category>
            <dc:creator><![CDATA[Thales Gaddini]]></dc:creator>
            <pubDate>Wed, 05 May 2021 14:19:16 GMT</pubDate>
            <atom:updated>2022-03-09T04:24:56.137Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9NeRDDpBs18FeN8UOx5sSA.png" /></figure><p>Esse artigo tenta explicar o porque recomendamos realizar o polling de eventos de 30 em 30 segundos.</p><p>Quem nunca fez um pedido, deixou o celular de lado e só voltou a checar meia hora depois para ver que o pedido havia sido cancelado por falta de confirmação do pedido? Não é somente uma experiência extremamente ruim para o usuário como também pode acarretar em penalizações ao parceiro por ter cancelamentos sem justificativa.</p><p>No iFood estamos sempre trabalhando para melhorar a experiência dos nossos clientes, e por isso tentamos identificar se o merchant realmente está apto a receber pedidos naquele momento de maneira a reduzir essa má experiência.</p><p>Para um merchant aparecer como aberto no aplicativo, vários critérios precisam ser atendidos, como: estar dentro do horário de funcionamento configurado, ter um cardápio configurado e algumas outras condições. Um critério extremamente importante é “estar online na plataforma”.</p><p>Hoje nós definimos um merchant como “online na plataforma” se ele estiver recebendo eventos de pedidos. Na prática, hoje isso significa que o merchant deve:</p><ul><li>ou estar fazendo polling de eventos com uma conta com acesso àquele merchant;</li><li>ou estar conectado no tópico do merchant do nosso broker MQTT (ainda não disponível para integrações no momento).</li></ul><p>Toda* request de polling envia um heartbeat que é processado assincronamente por nossos serviços internos. Ao fazer um polling garantimos que o merchant fique imediatamente online na plataforma (ou continue online). A questão que surge é: <strong>quando podemos assumir que o merchant ficou offline a partir do último heartbeat?</strong></p><p>Poderíamos simplesmente dizer que após um tempo X que todo e qualquer merchant está offline. O problema é que temos parceiros com conexões à internet de baixa qualidade, e escolher um tempo X muito baixo faz com que o status deles oscilem muito na plataforma, o que reduz, e muito, a possibilidade de eles receberem pedidos. Por outro lado, escolher um X muito alto significa um aumento no número de pedidos cancelados sem confirmação, onde o parceiro fecha o app mas continua online na plataforma por um período de tempo maior do que o desejado.</p><p>Por conta disso temos dois valores que ditam o tempo para dizer se um merchant está offline: uma constante de 45 segundos (valor configurado atualmente) para todos os merchants e um tempo extra calculado individualmente para cada merchant levando em consideração o tempo em que ele fica sem enviar heartbeats (sem fazer polling com sucesso), que chamamos de tempo de <strong>flapping</strong>. Esse tempo também pode chegar a 45 segundos, totalizando um tempo máximo de 90 segundos até o merchant ficar offline na plataforma.</p><p>É por conta disso que recomendamos o polling de 30 em 30 segundos, onde um polling pode falhar mas ainda sim o merchant continuará online na plataforma até o próximo polling, com um pouco de tempo de sobra. Caso o intervalo seja superior a esse tempo, corre o risco do merchant ser fechado na plataforma, e por isso é importante garantir a regularidade do polling!</p><p>* Apenas requests de polling com um header específico não emitem heartbeats. Esse header é utilizado em cenários em que o cliente consome eventos sem alterar o status do merchant para online (modo oculto), mas isso é assunto para um outro artigo.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=aa010fec7713" width="1" height="1" alt=""><hr><p><a href="https://medium.com/ifood-developer/status-de-conex%C3%A3o-dos-parceiros-no-ifood-aa010fec7713">Status de Conexão dos Parceiros no iFood</a> was originally published in <a href="https://medium.com/ifood-developer">ifood-developer</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>