Integrações de pedidos: como ligar iFood, 99Food, Anota AI, Aiqfome e outras plataformas no sistema
A guia Integrações de Pedidos conecta iFood, 99Food, Anota AI, Aiqfome e outras plataformas, para os pedidos delas entrarem sozinhos na tela de Pedidos e na cozinha.
A guia Integrações de Pedidos, nas Configurações da loja, é onde a pizzaria conecta as plataformas de delivery que já usa, como iFood, 99Food, Anota AI, Aiqfome, Wabiz Delivery, Delivery Lab e Cardápio Web. Com a integração ligada, o pedido feito na plataforma entra sozinho na tela de Pedidos e na cozinha, sem ninguém digitar nada no balcão.
Na mesma guia fica a 99Entrega, que funciona ao contrário: ela não traz pedidos, ela chama o entregador da 99 para levar os pedidos da sua loja.
Por que integrar as plataformas de delivery no sistema da pizzaria
Sem integração, cada pedido do aplicativo precisa ser lido num tablet e digitado de novo no caixa. É nessa redigitação que nasce o sabor trocado, o endereço errado, o pedido esquecido na hora do movimento e a cozinha que só fica sabendo do pedido minutos depois. Integrado, o pedido chega igual ao que o cliente escolheu, vai para a fila da cozinha junto com os do balcão e do salão, e aparece no contador da tela de Pedidos com a origem certa.
Outra vantagem é enxergar problema de configuração antes de perder pedido: a própria tela avisa quando uma integração está ligada mas falta um dado obrigatório para ela funcionar.
Como funciona cada cartão de integração
No topo da guia, o quadro Integrações Inteligentes mostra o nome da loja que está sendo configurada. Não existe botão de salvar: cada campo alterado é gravado sozinho, menos de um segundo depois, e aparece o aviso Integração salva. Acima de tudo, a busca da página encontra qualquer configuração, de todas as guias.
Cada plataforma tem um cartão próprio, com três caixas no alto:
- Cupom de avaliação: quando o pedido é finalizado no KDS, imprime na impressora de expedição um cupom pedindo avaliação, com o contato da loja.
- Contar no Painel: os pedidos dessa plataforma entram no contador por origem da tela de Pedidos.
- Ativar: liga a integração. Desligada, nenhum pedido dela entra.
Todo campo de senha ou token nasce escondido, e o ícone de olho mostra o que foi digitado. Embaixo de cada cartão há o lembrete Prioridade na cozinha: a ordem em que os pedidos de cada plataforma vão para a produção se define em Operacional › Ordem da Fila do KDS, arrastando os canais, inclusive cada conta do iFood separadamente.
Passo a passo por plataforma
- Wabiz Delivery: preencha a URL da API, o Usuário / Login e a Senha / Token fornecidos pelo Wabiz e marque Ativar.
- Anota AI: basta colar o Token de Integração. Se a integração estiver ligada sem o token, o cartão mostra o aviso amarelo Ligada, mas não vai receber pedidos, dizendo o que falta.
- Aiqfome: informe o Nome da loja (integração principal), que serve só para você identificar a conta, e o Store ID, o número da loja no Aiqfome. Depois clique em Conectar Aiqfome Automaticamente: abre a janela do Magalu para autorizar. Ao voltar para a tela, o cartão mostra Aiqfome Conectado. Marque Ativar.
- Delivery Lab: preencha o Merchant ID (o número da loja no Delivery Lab), o Client ID e o Client Secret.
- iFood: informe o nome da loja e o Merchant ID, que é o ID da sua loja no iFood.
- Cardápio Web: cole o Token de Autenticação (API Key), gerado no portal do Cardápio Web em Configurações, Integrações, API. A opção Ambiente de Testes (Sandbox) é só para desenvolvimento e deve ficar desligada.
- 99Food: a conexão é em dois passos. Preencha o Store ID e clique em Conectar 99Food Automaticamente. O sistema abre o portal da 99 em outra aba para você entrar e autorizar o Aliv Hub. Depois de autorizar, volte e clique em OK na janela Autorize na 99Food: o sistema busca o token sozinho e salva. Em seguida, marque Ativar.
- 99Entrega: preencha o Client ID e o Client Secret do modo de desenvolvedor da 99. Copie a URL do Webhook com o botão Copiar e cole no portal da 99. A 99 gera a Chave de assinatura: copie de lá e cole no segundo campo.
💡 Desconectar pede confirmação. No Aiqfome e na 99Food, o botão Desconectar abre uma confirmação, porque desconectada a plataforma deixa de mandar pedidos. A integração também é desligada, então depois de conectar de novo é preciso marcar Ativar.
Mais de uma loja no iFood: filiais e entregador
No iFood, na 99Food e no Aiqfome existe a área Filiais Adicionais (Multi-Lojas), para integrar mais de uma conta da mesma plataforma no mesmo painel. É um recurso adicional do plano: sem ele, o botão Adicionar Filial avisa que o Multi-Lojas é um add-on e orienta falar com o suporte.
Com o recurso liberado, clique em Adicionar Filial, dê um nome para identificar a loja e preencha o identificador da conta (no iFood, o Merchant ID; na 99Food, o app_shop_id e o token; no Aiqfome, o Store ID). Ao lado de cada filial aparece um selo: Conectada quando a conta tem tudo o que precisa, ou o que está faltando. A lixeira remove a filial.
Quando o iFood tem duas contas ou mais, aparece o quadro Loja do iFood que chama o entregador. Nos pedidos da própria loja, feitos no PDV, no app ou no WhatsApp, o entregador do iFood sob demanda é chamado pela conta escolhida, e a taxa sai dela. Em Automático (primeira conta), vale a primeira conta. Pedido que veio do iFood sempre usa a conta de onde veio.
Dicas, cuidados e erros comuns
- Aviso amarelo no cartão quer dizer integração ligada com campo obrigatório vazio: a plataforma não consegue identificar a loja e os pedidos não entram. Preencha o campo indicado.
- Aviso vermelho aparece quando uma das contas conectadas está quebrada: parece conectada, mas não recebe pedido. No Aiqfome, a causa mais comum é ter autorizado com a conta pessoal do Magalu em vez da organização dona da loja; reconecte escolhendo a organização.
- A conexão caiu aparece quando a autorização de uma conta do Aiqfome deixou de valer: os pedidos dessa conta não entram, e o aviso mostra qual é. Clique em Reconectar e escolha a organização dona dela; as outras contas não são afetadas. Na filial, o selo muda para Caiu: reconecte. Não use Desconectar nesse caso, porque ele remove todas as contas do Aiqfome.
- Na 99Entrega, o Contar no Painel nasce desmarcado, porque ela não é fonte de pedido. É o Client ID que define se o ambiente é de teste ou de produção; a opção Estas são credenciais de TESTE é só um rótulo. Com credencial de produção, toda corrida é real e cobrada.
- Sem a Chave de assinatura da 99Entrega, o rastreio em tempo real não é validado.
⚠️ Credencial é segredo. Tokens, senhas e Client Secret dão acesso aos pedidos da loja na plataforma. Não envie por mensagem para quem não precisa e prefira colar direto no campo.
Ligação com o resto do sistema
Os pedidos integrados entram na tela de Pedidos, no contador por origem (quando o Contar no Painel está marcado) e no KDS, na ordem definida em Operacional › Ordem da Fila do KDS. O Cupom de avaliação sai na impressora de expedição ao finalizar o pedido no KDS. Para os itens do pedido baixarem o estoque certo, cada produto precisa do código da plataforma cadastrado no Cardápio.
Perguntas frequentes
Por que a integração está ligada e mesmo assim não chega pedido?
Confira se o cartão mostra o aviso amarelo Ligada, mas não vai receber pedidos. Ele aparece quando falta um campo obrigatório, como o token do Anota AI ou o Store ID do Aiqfome, e diz exatamente qual campo preencher.
Dá pra integrar duas lojas do iFood no mesmo painel?
Dá, com o recurso de Filiais Adicionais (Multi-Lojas), que é um adicional do plano. Com ele liberado, cada filial ganha nome, identificador e um selo que mostra se a conta está pronta para receber pedidos.
O que acontece se eu desconectar o Aiqfome ou a 99Food?
A plataforma deixa de mandar pedidos e a integração é desligada, e no Aiqfome isso remove todas as contas, não só a principal. Para voltar, clique em Conectar novamente, autorize na janela da plataforma e marque Ativar no cartão, porque a desconexão desmarca essa caixa.
Cliquei em Reconectar no Aiqfome e apareceu Não foi possível iniciar a conexão. O que faço?
Essa mensagem quer dizer que a janela do Magalu nem chegou a abrir, então nada mudou nas suas contas. Costuma ser uma instabilidade momentânea do sistema ou da internet: espere alguns minutos e clique em Reconectar de novo. Não use Desconectar, porque ele remove todas as contas do Aiqfome. Se continuar aparecendo, chame o suporte e diga o horário da tentativa.
Apareceu a faixa Integração desconectada do Aiqfome, mas o cartão mostra as lojas conectadas. Como reconecto só a conta que caiu?
Em Integrações de Pedidos, no cartão do Aiqfome, aparece o aviso A conexão caiu com o nome da conta e o botão Reconectar. Clique nele e, na janela do Magalu, escolha a organização dona daquela loja. Só a conta que caiu é atualizada e as outras continuam recebendo. Não use Desconectar, que remove todas as contas.
Reconectei o Aiqfome e apareceu que a autorização é de outra loja. O que eu faço?
Você escolheu outra organização na janela do Magalu. Clique em Reconectar de novo e escolha a organização dona da conta indicada na mensagem. Nenhuma conta foi alterada.
A 99Entrega traz pedidos para o sistema?
Não. A 99Entrega serve para chamar o entregador da 99 para os pedidos da sua loja. Por isso o Contar no Painel dela nasce desmarcado. Os pedidos do aplicativo 99 entram pela integração 99Food, que fica em outro cartão.
Marquei o pedido da Wabiz como pago e salvei, mas ele continua A Receber no app do motoboy. Por quê?
Com a opção Cobrar o Pix da Wabiz pelo Aliv Hub ligada, o pedido em Pix da Wabiz recebe um QR Code do Aliv Hub. Agora, marcar Pedido Pago já tira o A Receber, mesmo que esse QR não tenha sido pago, então marque só depois de conferir que o dinheiro entrou. Sem a marcação, o pedido segue A Receber até o Mercado Pago confirmar o QR. Para não acontecer de novo, no painel da Wabiz tire a chave Pix da forma de pagamento e deixe só o aviso de que o QR Code do Pix chega no WhatsApp: assim o cliente paga só pelo QR do Hub e o pedido já fica pago sozinho. Se não conseguir tirar a chave ou preferir receber direto por ela, desligue Cobrar o Pix da Wabiz pelo Aliv Hub no cartão da Wabiz, em Integrações de Pedidos.
Consigo utilizar o cardápio digital da Wabiz junto com o sistema?
Consegue. Em Configurações, Integrações de Pedidos, preencha no cartão Wabiz Delivery a URL da API, o Usuário e a Senha fornecidos pela Wabiz e marque Ativar. O cliente continua pedindo pelo cardápio da Wabiz, e o pedido cai no Aliv Hub, onde a cozinha e o motoboy trabalham. O cardápio não é copiado de um para o outro: o que o cliente vê na Wabiz, você edita no painel da Wabiz.
Liguei o Cobrar o Pix da Wabiz pelo Aliv Hub, mas não tenho como tirar a chave Pix. Onde tiro?
Essa chave Pix não fica no Aliv Hub, ela fica no painel da própria Wabiz, na forma de pagamento Pix de lá. É dentro do painel da Wabiz que você tira a chave Pix da forma de pagamento e deixa escrito algo como "o QR Code do Pix chega no seu WhatsApp". Enquanto a chave continuar aparecendo na Wabiz com o Cobrar o Pix da Wabiz pelo Aliv Hub ligado, o cliente pode acabar pagando duas vezes: uma pela chave da Wabiz e outra pelo QR do Hub. Se você não achar onde tirar essa chave no painel da Wabiz, peça ao suporte da Wabiz para remover ou esconder a chave Pix da forma de pagamento. E se preferir continuar recebendo direto pela chave da Wabiz, como sempre foi, é só desligar o Cobrar o Pix da Wabiz pelo Aliv Hub no cartão da Wabiz, em Configurações, Integrações de Pedidos, que o Hub para de gerar o QR.