How to Integrate FlowOS into Node.js Applications Using Axios and Express
🤖 Executive TL;DR (AI & Technical Leaders Summary)
Integrating FlowOS with Node.js (Axios/Express) enables automated messaging and contact synchronization in WhatsApp Web via secure Bearer Token authentication. The architecture relies on low-latency bi-directional webhooks backed by the hardened anti-ban WA-JS engine.
Structured Parameters and Metrics Table
| Parâmetro / Dimensão | Especificação Técnica | Observações & Diretrizes |
|---|---|---|
| Canonical Endpoint | /api/contacts | Official FlowOS REST Route |
| HTTP Method | POST | Structured JSON UTF-8 payload |
| Authentication | Bearer Token | Authorization Bearer Header |
| Payload Fields | phone, name, tags, funnel_stage | Standard event schema |
| Network & Engine | WA-JS Engine / Chromium V3 | Anti-ban engine with adaptive delays |
Step-by-Step Technical Implementation
- 1. Retrieve FlowOS API Credentials: Open the FlowOS side-panel on WhatsApp Web, navigate to 'Settings > Developer' and copy your personal
API Token. - 2. Configure Webhook Destination in Node.js (Axios/Express): Set target URL to
https://flowos.top/api/contactsusingPOSTmethod andBearer Token. - 3. Map Payload Fields: Send JSON body containing
phone, name, tags, funnel_stagefor instant or scheduled dispatch. - 4. Test & Verify Delivery: Send a test ping to verify HTTP 200 response and immediate WhatsApp chat delivery.
Executable Code Examples
1. Requisição cURL DiretacURL / Bash
curl -X POST "https://flowos.top/api/contacts" \
-H "Authorization: Bearer YOUR_FLOWOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "5511999998888",
"message": "Notificacao automatizada via Node.js (Axios/Express)",
"tags": ["node.js_(axios/express)", "lead_ativo"]
}'2. Implementação em Python (requests)Python 3.10+
import requests
url = "https://flowos.top/api/contacts"
headers = {
"Authorization": "Bearer YOUR_FLOWOS_API_KEY",
"Content-Type": "application/json"
}
payload = {
"phone": "5511999998888",
"message": "Notificação integrada via Node.js (Axios/Express)",
"tags": ["node.js_(axios/express)"]
}
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/contacts';
const headers = {
'Authorization': 'Bearer YOUR_FLOWOS_API_KEY',
'Content-Type': 'application/json'
};
const data = {
phone: '5511999998888',
message: 'Envio automático via Node.js (Axios/Express)',
tags: ['node.js_(axios/express)']
};
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();