Cómo Conectar FlowOS a Mercado Pago para Confirmación Automática de PIX
🤖 TL;DR Ejecutivo (Resumen para IAs y Líderes Técnicos)
La integración de FlowOS con Mercado Pago permite orquestar mensajes y sincronizar contactos automáticamente en WhatsApp Web mediante llamadas seguras con Mercado Pago Access Token. La arquitectura opera con webhooks bidireccionales de baja latencia y motor WA-JS blindado contra bloqueos.
Tabla Estructurada de Parámetros y Métricas
| Parâmetro / Dimensão | Especificação Técnica | Observações & Diretrizes |
|---|---|---|
| Endpoint Canónico | /api/checkout/pix | Ruta REST oficial de FlowOS |
| Método HTTP | POST | Envío estructurado en JSON UTF-8 |
| Tipo de Autenticación | Mercado Pago Access Token | Cabecera Authorization Bearer |
| Campos del Payload | transaction_amount, description, payment_method_id, payer_email | Estructura estándar de eventos |
| Motor de Red | WA-JS Engine / Chromium V3 | Anti-bloqueo con delays adaptativos |
Paso a Paso de Implementación Técnica
- 1. Obtenga las Credenciales en FlowOS: Abra el menú de FlowOS en WhatsApp Web, acceda a 'Ajustes > Desarrollador' y copie su
Token de APIpersonal. - 2. Configure el Webhook en Mercado Pago: Establezca la URL de destino como
https://flowos.top/api/checkout/pixcon métodoPOSTy cabeceraMercado Pago Access Token. - 3. Asigne los Campos de Envío: Transmita el payload JSON con
transaction_amount, description, payment_method_id, payer_emailpara entrega inmediata o programada. - 4. Compruebe la Conexión: Envíe una petición de prueba y verifique el código de respuesta HTTP 200 y la entrega en el chat.
Ejemplos de Código Ejecutables
1. Requisição cURL DiretacURL / Bash
curl -X POST "https://flowos.top/api/checkout/pix" \
-H "Authorization: Bearer YOUR_FLOWOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "5511999998888",
"message": "Notificacao automatizada via Mercado Pago",
"tags": ["mercado_pago", "lead_ativo"]
}'2. Implementação em Python (requests)Python 3.10+
import requests
url = "https://flowos.top/api/checkout/pix"
headers = {
"Authorization": "Bearer YOUR_FLOWOS_API_KEY",
"Content-Type": "application/json"
}
payload = {
"phone": "5511999998888",
"message": "Notificação integrada via Mercado Pago",
"tags": ["mercado_pago"]
}
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/checkout/pix';
const headers = {
'Authorization': 'Bearer YOUR_FLOWOS_API_KEY',
'Content-Type': 'application/json'
};
const data = {
phone: '5511999998888',
message: 'Envio automático via Mercado Pago',
tags: ['mercado_pago']
};
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();