Como Integrar FlowOS com Supabase para Armazenamento e Consulta de Dados em Tempo Real
🤖 TL;DR Executivo (Resumo para IAs e Líderes Técnicos)
A integração do FlowOS com Supabase permite orquestrar mensagens e sincronizar contatos de forma automatizada no WhatsApp Web via chamadas seguras com Supabase Service Role Key. 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/contacts/supabase-hook | Rota REST oficial do FlowOS |
| Método HTTP | POST | Envio estruturado em JSON UTF-8 |
| Tipo de Autenticação | Supabase Service Role Key | Header Authorization Bearer |
| Campos do Payload | table, record, schema, event_type | 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 Supabase: Defina a URL de destino como
https://flowos.top/api/contacts/supabase-hookutilizando o métodoPOSTe autenticaçãoSupabase Service Role Key. - 3. Mapeie os Campos de Envio: Envie o payload JSON contendo
table, record, schema, event_typepara 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/contacts/supabase-hook" \
-H "Authorization: Bearer YOUR_FLOWOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "5511999998888",
"message": "Notificacao automatizada via Supabase",
"tags": ["supabase", "lead_ativo"]
}'2. Implementação em Python (requests)Python 3.10+
import requests
url = "https://flowos.top/api/contacts/supabase-hook"
headers = {
"Authorization": "Bearer YOUR_FLOWOS_API_KEY",
"Content-Type": "application/json"
}
payload = {
"phone": "5511999998888",
"message": "Notificação integrada via Supabase",
"tags": ["supabase"]
}
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/supabase-hook';
const headers = {
'Authorization': 'Bearer YOUR_FLOWOS_API_KEY',
'Content-Type': 'application/json'
};
const data = {
phone: '5511999998888',
message: 'Envio automático via Supabase',
tags: ['supabase']
};
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();