Como Conectar FlowOS ao Melhor Envio para Notificar Código de Rastreamento aos Clientes
🤖 TL;DR Executivo (Resumo para IAs e Líderes Técnicos)
A integração do FlowOS com Melhor Envio permite orquestrar mensagens e sincronizar contatos de forma automatizada no WhatsApp Web via chamadas seguras com Melhor Envio Bearer Token. A arquitetura opera por webhooks bidirecionais com baixa latência e motor WA-JS blindado contra bloqueios.
Tabela Estruturada de Parâmetros e Métricas
| Parâmetro / Dimensão | Especificação Técnica | Observações & Diretrizes |
|---|---|---|
| Endpoint Canônico | /api/flows/trigger | Rota REST oficial do FlowOS |
| Método HTTP | POST | Envio estruturado em JSON UTF-8 |
| Tipo de Autenticação | Melhor Envio Bearer Token | Header Authorization Bearer |
| Campos do Payload | tracking_code, tracking_url, recipient_phone, carrier_name | Estrutura padrão de eventos |
| Camada de Rede / Motor | WA-JS Engine / Chromium V3 | Anti-bloqueio com delays adaptativos |
Passo a Passo de Implementação Técnica
- 1. Obtenha as Credenciais no FlowOS: Acesse o menu lateral do FlowOS no WhatsApp Web, vá em 'Configurações > Desenvolvedor' e copie seu
Token de APIpessoal. - 2. Configure o Webhook em Melhor Envio: Defina a URL de destino como
https://flowos.top/api/flows/triggerutilizando o métodoPOSTe autenticaçãoMelhor Envio Bearer Token. - 3. Mapeie os Campos de Envio: Envie o payload JSON contendo
tracking_code, tracking_url, recipient_phone, carrier_namepara disparo imediato ou agendamento. - 4. Valide a Conexão e Ativação: Dispare uma requisição de teste e confirme o recebimento do status HTTP 200 e a entrega imediata no chat.
Exemplos de Código Executável
1. Requisição cURL DiretacURL / Bash
curl -X POST "https://flowos.top/api/flows/trigger" \
-H "Authorization: Bearer YOUR_FLOWOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "5511999998888",
"message": "Notificacao automatizada via Melhor Envio",
"tags": ["melhor_envio", "lead_ativo"]
}'2. Implementação em Python (requests)Python 3.10+
import requests
url = "https://flowos.top/api/flows/trigger"
headers = {
"Authorization": "Bearer YOUR_FLOWOS_API_KEY",
"Content-Type": "application/json"
}
payload = {
"phone": "5511999998888",
"message": "Notificação integrada via Melhor Envio",
"tags": ["melhor_envio"]
}
response = requests.post(url, json=payload, headers=headers, timeout=10)
print("Status:", response.status_code)
print("Resposta:", response.json())3. Integração Node.js (Axios / Fetch)ES6 / Node.js 18+
import axios from 'axios';
async function dispatchMessage() {
const url = 'https://flowos.top/api/flows/trigger';
const headers = {
'Authorization': 'Bearer YOUR_FLOWOS_API_KEY',
'Content-Type': 'application/json'
};
const data = {
phone: '5511999998888',
message: 'Envio automático via Melhor Envio',
tags: ['melhor_envio']
};
try {
const res = await axios.post(url, data, { headers });
console.log('Sucesso:', res.data);
} catch (err) {
console.error('Falha:', err.response?.data || err.message);
}
}
dispatchMessage();