# LetsGoPedir — integrações, conectores e APIs

- Catálogo canônico: https://letsgopedir.com.br/integrations.txt
- Plataforma: LetsGoPedir
- Categoria: Conectores e Protocolos de Integração
- Idioma: pt-BR
- Revisado em: 2026-09-26

## Visão Geral das Integrações

O LetsGoPedir foi desenhado para se integrar de forma fluida aos canais e ferramentas que os restaurantes e clientes já utilizam no dia a dia: mensageria instantânea via WhatsApp, pagamentos instantâneos via PIX e Mercado Pago, preenchimento automático de endereços e impressão física de comandas.

---

## 1. Conector WhatsApp (WuzAPI)

O conector nativo de WhatsApp permite a comunicação bidirecional e o disparo automatizado de atualizações para clientes e lojistas.

- **Status:** Ativo e em produção [active]
- **Mecanismo:** Instância dedicada do micro-serviço WuzAPI rodando em container Docker isolated.
- **Capacidades:**
  - Envio de comprovante completo de pedido recém-criado com itens, valores, taxa de frete e forma de pagamento.
  - Notificação de mudança de status: "Pedido Confirmado", "Em Preparo", "Saiu para Entrega", "Disponível para Retirada no Balcão" e "Pedido Cancelado".
  - Envio de códigos de segurança de uso único (OTP) para confirmação de telefone e autenticação rápida.
  - Suporte a templates customizáveis pelo administrador da plataforma através do painel de controle.
- **Resiliência:** Mecanismo automático de reconexão, verificação de integridade da sessão e auto-provisionamento de instância via Docker Compose.

---

## 2. Gateway de Pagamento: Mercado Pago

Integração oficial para liquidação instantânea de pagamentos online e split de recebíveis.

- **Status:** Ativo e em produção [active]
- **Métodos:**
  - **PIX Dinâmico:** Geração de código copia-e-cola e QR Code de checkout em tempo real.
  - **Cartão de Crédito e Débito:** Processamento de pagamentos com autenticação 3D Secure.
- **Webhooks:**
  - Processamento assíncrono de notificações de pagamento (`/mercadopago/mercadopago_process.php`).
  - Atualização automática do status do pedido no painel do lojista assim que o pagamento for aprovado pelo banco.
  - Prevenção contra ataques de replay e verificação de assinatura de payload.

---

## 3. PIX Direto (Chave do Lojista)

Possibilita ao lojista receber pagamentos via PIX diretamente na sua conta bancária sem passar por intermediários ou pagar tarifas de gateway.

- **Status:** Ativo e em produção [active]
- **Capacidades:**
  - Geração de payload padrão EMV (PIX Copia e Cola) no padrão do Banco Central do Brasil.
  - Geração visual de QR Code para leitura rápida pela tela do smartphone ou desktop.
  - Exibição de instruções amigáveis para envio do comprovante pelo WhatsApp da loja.

---

## 4. Consulta de CEP e Cálculo de Frete por Distância

- **Status:** Ativo e em produção [active]
- **Capacidades:**
  - Preenchimento inteligente de endereço (logradouro, bairro, cidade, UF) a partir do CEP informado pelo cliente no checkout.
  - **Cálculo de Frete por Raio (km):** Cálculo preciso da distância geodésica entre o endereço do restaurante e o cliente, aplicando faixas de preços configuradas pelo lojista.
  - **Cálculo por Bairros:** Tabela personalizada com valores de taxa fixa por localidade/bairro atendido.
  - Validação de entrega fora da área de cobertura do restaurante com bloqueio preventivo de finalização de pedido inválido.

---

## 5. Web Push e PWA (Progressive Web App)

- **Status:** Ativo e em produção [active]
- **Capacidades:**
  - Instalação do cardápio como Web App na tela inicial do cliente (Add to Home Screen).
  - Service Workers dedicados para cache de recursos essenciais e carregamento ultrarrápido em conexões 3G/4G/5G.
  - Notificações de alerta sonoro contínuo no painel do lojista para novos pedidos recebidos.

---

## 6. Impressão Térmica de Pedidos (ESC/POS)

- **Status:** Ativo e em produção [active]
- **Capacidades:**
  - Layout otimizado para impressão direta em bobinas térmicas de 58mm e 80mm.
  - Compatibilidade com qualquer impressora térmica USB, Wi-Fi ou Bluetooth conectada ao computador ou smartphone do operador.
  - Impressão automática ou manual com formatação limpa e legível para a equipe de cozinha e entregadores.