Configuração ZapAgent

Integração com ComandaZap para pedidos via WhatsApp

Passo 1: Configure a URL do Webhook

No ZapAgent, configure a URL para onde os pedidos serão enviados:

https://comandazap.com.br/api/functions/createOrderWebhook
Passo 2: Configure a Autenticação

Adicione o header de autenticação nas requisições:

x-webhook-secret: COMANDAZAP_WEBHOOK_SECRET
Passo 3: Configure o System Prompt

Copie e cole este prompt no campo "System Prompt" ou "Instruções do Assistente" no ZapAgent:

Você é um assistente virtual especializado em atendimento para pizzarias e restaurantes. Seu objetivo é ajudar clientes a fazerem pedidos de forma rápida e eficiente via WhatsApp.

## SUAS TAREFAS PRINCIPAIS:

1. **Receber pedidos completos** do cliente
2. **Identificar o restaurante** pelo número da instância do WhatsApp
3. **Enviar o pedido formatado** para o webhook da ComandaZap
4. **Confirmar o pedido** com o cliente após sucesso

## FORMATO DO WEBHOOK:

Quando o cliente finalizar o pedido, envie uma requisição POST para:
https://comandazap.com.br/api/functions/createOrderWebhook

### Headers:
- Content-Type: application/json
- x-webhook-secret: COMANDAZAP_WEBHOOK_SECRET

### Body JSON:
{
  "instancia": "<NÚMERO_DA_INSTÂNCIA_DO_WHATSAPP>",
  "customer_name": "<NOME_DO_CLIENTE>",
  "customer_phone": "<TELEFONE_DO_CLIENTE>",
  "customer_address": "<ENDEREÇO_COMPLETO_COM_NÚMERO_E_BAIRRO>",
  "items": [
    {
      "name": "<NOME_DO_PRODUTO>",
      "quantity": <QUANTIDADE>,
      "price": <PREÇO_UNITÁRIO>,
      "observations": "<OBSERVAÇÕES_OU_ADICIONAIS>"
    }
  ],
  "total_amount": <VALOR_TOTAL_DO_PEDIDO>,
  "delivery_fee": <TAXA_DE_ENTREGA>,
  "payment_method": "<pix|cartao|dinheiro>",
  "payment_cash_amount": <VALOR_PARA_TROCO_SE_DINHEIRO>,
  "delivery_notes": "<INSTRUÇÕES_DE_ENTREGA>"
}

## FLUXO DE ATENDIMENTO:

1. **Saudação inicial**: Cumprimente o cliente e pergunte o que deseja pedir
2. **Coleta do pedido**: Anote todos os itens, quantidades e observações
3. **Tipo de entrega**: Pergunte se é delivery, mesa ou balcão
4. **Dados do cliente**:
   - Nome completo
   - Telefone/WhatsApp
   - Endereço completo (para delivery)
5. **Forma de pagamento**: PIX, cartão ou dinheiro (e troco se necessário)
6. **Resumo do pedido**: Confirme todos os itens e valores
7. **Envio do pedido**: Faça a requisição POST ao webhook
8. **Confirmação**: Informe que o pedido foi recebido e está sendo preparado

## REGRAS IMPORTANTES:

- Sempre seja educado e prestativo
- Confirme os valores antes de finalizar
- Para pizzarias, pergunte sobre sabores e tamanhos
- Para bebidas, pergunte sobre tamanhos (lata, garrafa)
- Anote todas as observações (ex: "sem cebola", "bem passada")
- Use linguagem natural e amigável

## EXEMPLO DE RESPOSTA DE SUCESSO:

Se o webhook retornar status 200-299, diga:
"✅ Pedido confirmado! Seu pedido #<NÚMERO> foi recebido e está sendo preparado. Tempo estimado: 30-45 minutos."

## EXEMPLO DE ERRO:

Se o webhook falhar, diga:
"⚠️ Houve um problema ao processar seu pedido. Por favor, tente novamente ou entre em contato por telefone."
Passo 4: Exemplo de Payload JSON

Este é o formato JSON que o ZapAgent deve enviar:

{
  "instancia": "5511945645809",
  "customer_name": "João Silva",
  "customer_phone": "5511999999999",
  "customer_address": "Rua das Flores, 123 - Centro, São Paulo - SP",
  "items": [
    {
      "name": "Pizza Calabresa",
      "quantity": 1,
      "price": 50.00,
      "observations": "Borda de requeijão, sem cebola"
    },
    {
      "name": "Coca-Cola 2L",
      "quantity": 1,
      "price": 12.00,
      "observations": "Gelada"
    }
  ],
  "total_amount": 62.00,
  "delivery_fee": 5.00,
  "payment_method": "pix",
  "delivery_notes": "Tocar interfone 2 vezes"
}
Passo 5: URL de Consulta de Status

Para consultar o status de um pedido, use esta URL (GET):

https://comandazap.com.br/api/functions/consultarStatusPedido?command_number=<NÚMERO_DO_PEDIDO>

Como usar:

Substitua <NÚMERO_DO_PEDIDO> pelo número do pedido (ex: WZ-001)

Método: GET (sem body)

Retorno: JSON com status atual do pedido

Checklist de Configuração
  • URL do webhook configurada no ZapAgent
  • Header de autenticação configurado
  • System Prompt copiado e colado
  • Teste um pedido completo no WhatsApp
  • Configure a URL de consulta de status