6 min de leitura ·com vídeo

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.
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. Para voltar, clique em Conectar novamente, autorize na janela da plataforma e marque Ativar no cartão, porque a desconexão desmarca essa caixa.

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.