Nó Tray

O nó de workflow Tray é um cliente REST para a Tray Commerce API. Use-o para consultar e gerenciar pedidos, produtos e clientes de lojas hospedadas na Tray.

Node ID no editor: tray_request
URL padrão: GET https://api.tray.com.br/{{tray_api_version}}/orders

O que faz

• Envia requisições HTTP autenticadas para a API da Tray
• Suporta GET, POST, PUT e DELETE
• Retorna HTTP status, data da resposta e headers da resposta
• Auth padrão: Authorization: Basic {{tray_api_key}}

Pré-requisitos

1. Uma loja Tray Commerce
2. API key do admin Tray (Integrações / API)
3. Integration key em Configurações → API Keys:
   • tray_api_key — credenciais codificadas em Base64 ou valor da API key conforme exigido pela Tray

Como configurar

Passo 1 — Definir credenciais

A Tray usa Basic authentication. Armazene o valor da credencial em tray_api_key — tipicamente a string codificada em Base64 fornecida pela Tray, ou codifique conforme a documentação Tray.

Passo 2 — Adicionar o nó

Arraste Tray de E-commerce para o canvas.

Passo 3 — Configurar requisição

Templates de operação integrados

Exemplo — criar cliente (POST body):

{
  "name": "{{contact.name}}",
  "email": "{{contact.email}}",
  "cpf_cnpj": "{{variables.cpf}}"
}

A versão da API Tray é tipicamente 1.0 — confirme na documentação de desenvolvedor Tray.

Passo 4 — Usar dados da resposta

Order ID: {{tray_1.data.Order.id}}
Customer phone: {{tray_1.data.Customer.phone}}

Inspecione a saída de execução para caminhos exatos — respostas Tray encapsulam entidades em Order, Customer, etc.

Saídas do nó

Dicas e boas práticas

• Endpoints de listagem Tray frequentemente usam sufixo /list (ex.: /orders/list) — use templates integrados para evitar 404
• Configure webhooks Tray para eventos de pedido; use este nó para buscar detalhes completos após a notificação
• Armazene Tray customer IDs nos contatos WhatsWave para fluxos idempotentes de create/update
• Teste com um GET de pedido único antes de montar loops sobre listas de pedidos

Exemplos de uso

Pagamento confirmado → WhatsApp

1. Webhook — mudança de status do pedido Tray
2. Tray GET — pedido por ID
3. Send WhatsApp — confirmação com total do pedido

Relatório diário de pedidos pendentes

1. Schedule — 8:00 em dias úteis
2. Tray GET — /orders/list com filtro de status
3. Loop + Send message — notificar equipe comercial

FAQ

Por que 401 Unauthorized?
tray_api_key ausente ou codificação Base64 incorreta. Verifique configurações de integração Tray.

Qual versão da API devo usar?
Templates integrados usam 1.0. Consulte a documentação Tray se sua loja exigir caminho de versão diferente.

Posso atualizar status do pedido?
Sim — use PUT no endpoint de pedido conforme documentação Tray API.

Isso difere do nó HTTP?
Pré-configurado com URLs Tray, template Basic auth e atalhos de operação.

Referência da API

Relacionado

• Visão geral de E-commerce
• Webhook trigger
• Nó Loop