Referência da API FlowBridge

curl https://api.flowbridge.com.br/v1/workspaces \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY"

{
  "data": [
    {
      "id": "8d3f2a61-4b7e-4c1a-9f0d-2e6b5c4a7d10",
      "organization_id": "5b0c9e7a-2f41-4d8b-a6c3-7e1f0d9b4a25",
      "name": "Atendimento"
    }
  ]
}

curl https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/status \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY"

{
  "data": {
    "id": "c41e9b27-6a3d-4f58-b0e2-91d7f3a5c8e4",
    "name": "Vendas",
    "state": "active",
    "session_state": "connected",
    "connected": true,
    "phone_masked": "+55 11 9****-5678",
    "worker_alive": true,
    "lease_until": "2026-10-01T12:00:30.000Z",
    "reservation_state": "occupied",
    "reservation_expires_at": null,
    "created_at": "2026-09-28T14:03:11.000Z"
  }
}

# 1. Envie o arquivo (corpo binário, até 16 MiB)
curl -X POST "https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/media?kind=image" \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary @cardapio.jpg

# 2. Envie a mensagem com o id devolvido
curl -X POST https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/messages \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Idempotency-Key: cardapio-cliente-4821" \
  -H "Content-Type: application/json" \
  -d '{
    "to": { "kind": "phone", "value": "+5511912345678" },
    "type": "image",
    "media": { "id": "3f9d0c52-8e1b-4a7f-b6d4-0c2e9a1f5b73" },
    "caption": "Cardápio de hoje",
    "expires_at": "2026-10-01T18:00:00Z"
  }'

{
  "data": {
    "id": "e7a1c3d9-0b4f-4e62-9a85-1d3c7b2f6e04",
    "state": "queued",
    "provider_message_id": "3EB0A1B2C3D4E5F6071829",
    "client_reference": null,
    "expires_at": "2026-10-01T18:00:00.000Z",
    "created_at": "2026-10-01T12:00:00.000Z"
  }
}

curl "https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/chats?limit=1" \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY"

{
  "data": [
    {
      "jid": "5511912345678@s.whatsapp.net",
      "alt_jid": null,
      "is_group": false,
      "name": "Mariana Souza",
      "last_message": {
        "id": "3A5F09C2B1E4D7A8C6F0",
        "direction": "in",
        "kind": "text",
        "text": "Vocês abrem no sábado?",
        "timestamp": "2026-10-01T11:58:02.000Z"
      },
      "inbound_count": 4,
      "outbound_count": 3,
      "unread_count": 1,
      "last_activity_at": "2026-10-01T11:58:02.000Z"
    }
  ],
  "next_cursor": "WyIyMDI2LTEwLTAxVDExOjU4OjAyLjAwMFoiLCI1NTExOTEyMzQ1Njc4QHMud2hhdHNhcHAubmV0Il0",
  "window": { "rows_per_source": 2000, "truncated": false, "skipped": 0 }
}

curl -X POST https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/groups \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Idempotency-Key: grupo-clientes-vip" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Clientes VIP", "participants": ["+5511912345678"] }'

{
  "data": {
    "jid": "120363025246125888@g.us",
    "name": "Clientes VIP",
    "topic": "",
    "owner": "5511955554444@s.whatsapp.net",
    "owner_phone": "+5511955554444",
    "created_at": "2026-10-01T12:00:00Z",
    "participant_count": 2,
    "announce": false,
    "locked": false,
    "join_approval": false,
    "member_add_mode": "admins",
    "ephemeral_seconds": 0,
    "is_community": false,
    "parent_jid": null,
    "is_default_subgroup": false,
    "suspended": false,
    "participants": [
      {
        "jid": "5511955554444@s.whatsapp.net",
        "phone": "+5511955554444",
        "is_admin": true,
        "is_super_admin": true
      },
      {
        "jid": "5511912345678@s.whatsapp.net",
        "phone": "+5511912345678",
        "is_admin": false,
        "is_super_admin": false
      }
    ]
  }
}

curl -X POST https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/contacts/check \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phones": ["+5511912345678", "+5511900000000"] }'

{
  "data": {
    "items": [
      {
        "phone": "+5511912345678",
        "exists": true,
        "jid": "5511912345678@s.whatsapp.net",
        "lid": null,
        "verified_name": null
      },
      {
        "phone": "+5511900000000",
        "exists": false,
        "jid": null,
        "lid": null,
        "verified_name": null
      }
    ]
  }
}

curl -X POST https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/newsletters/120363144038483540@newsletter/posts \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Idempotency-Key: canal-promo-sexta" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Sexta tem frete grátis para todo o Brasil." }'

{
  "data": {
    "jid": "120363144038483540@newsletter",
    "id": "3EB0B7C2D9E4F1A6038571",
    "server_id": 128,
    "timestamp": "2026-10-01T12:00:01Z"
  }
}

curl https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/business/profile/5511955554444@s.whatsapp.net \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY"

{
  "data": {
    "jid": "5511955554444@s.whatsapp.net",
    "address": "Rua das Flores, 100 — São Paulo",
    "email": "contato@loja.example",
    "categories": [{ "id": "1001", "name": "Loja de roupas" }],
    "profile_options": {},
    "business_hours": null
  }
}

import { createHmac, timingSafeEqual } from "node:crypto";

// raw: corpo exato recebido (Buffer); secret: o "secret" do cadastro
export function assinaturaValida(headers, raw, secret) {
  const timestamp = headers["x-flow-timestamp"];
  const eventId = headers["x-flow-event-id"];
  const [versao, , hex] = String(headers["x-flow-signature"]).split(":");
  const idade = Math.abs(Date.now() / 1000 - Number(timestamp));
  if (versao !== "v1" || !(idade <= 300)) return false;
  const esperado = createHmac("sha256", Buffer.from(secret, "base64url"))
    .update(`${timestamp}.${eventId}.`)
    .update(raw)
    .digest();
  const recebido = Buffer.from(hex ?? "", "hex");
  return (
    recebido.length === esperado.length && timingSafeEqual(recebido, esperado)
  );
}

{
  "event_id": "4c2b8e1f-7a93-4d05-b6e8-2f1a0c9d3b57",
  "schema_version": "1.0",
  "type": "message.received",
  "occurred_at": "2026-10-01T12:00:00.000Z",
  "organization_id": "5b0c9e7a-2f41-4d8b-a6c3-7e1f0d9b4a25",
  "workspace_id": "8d3f2a61-4b7e-4c1a-9f0d-2e6b5c4a7d10",
  "instance_id": "c41e9b27-6a3d-4f58-b0e2-91d7f3a5c8e4",
  "sequence": 42,
  "data": { "resource_id": "9e3d7c1a-5b2f-4e80-a4c6-0d8b1f2e7a39" }
}

curl -X PUT https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/crm/leads/%2B5511912345678 \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mariana Souza",
    "status": "cliente",
    "opted_in": { "at": "2026-09-30T15:20:00Z", "source": "formulário do site" }
  }'

{
  "data": {
    "id": "a6f0d2c4-91b3-4e7a-8c15-3d9e2b7f0a61",
    "contact": "+5511912345678",
    "name": "Mariana Souza",
    "status": "cliente",
    "assigned_user_id": null,
    "tags": [],
    "fields": {},
    "opted_in": { "at": "2026-09-30T15:20:00.000Z", "source": "formulário do site" },
    "opted_out_at": null,
    "consented": true,
    "created_at": "2026-10-01T12:00:00.000Z",
    "updated_at": "2026-10-01T12:00:00.000Z"
  }
}

curl -X POST https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/campaigns \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Idempotency-Key: campanha-reabertura-outubro" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Aviso de reabertura",
    "message": { "type": "text", "text": { "body": "Reabrimos no sábado, das 9h às 18h." } },
    "recipients": { "tag_id": "d1b7e4a2-6c30-4f9e-8a51-2e7c0b9d4f36" },
    "scheduled_at": "2026-10-02T12:00:00Z",
    "respect_business_hours": true
  }'

{
  "data": {
    "id": "f2c8a0e6-3d71-4b95-9e24-7a1c5d0b8e43",
    "name": "Aviso de reabertura",
    "message_type": "text",
    "state": "scheduled",
    "pause_reason": null,
    "scheduled_at": "2026-10-02T12:00:00.000Z",
    "next_send_at": "2026-10-02T12:00:00.000Z",
    "delay_ms": { "min": 5000, "max": 15000 },
    "respect_business_hours": true,
    "total_recipients": 120,
    "skipped_unconsented": 0,
    "created_at": "2026-10-01T12:00:00.000Z",
    "started_at": null,
    "finished_at": null
  }
}

curl -X PUT https://api.flowbridge.com.br/v1/workspaces/$WORKSPACE/instances/$NUMERO/chatwoot \
  -H "Authorization: Bearer $FLOWBRIDGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://chatwoot.suaempresa.com.br",
    "account_id": 1,
    "inbox_id": 7,
    "api_access_token": "<token de acesso do Chatwoot>",
    "enabled": true
  }'

{
  "data": {
    "instance_id": "c41e9b27-6a3d-4f58-b0e2-91d7f3a5c8e4",
    "url": "https://chatwoot.suaempresa.com.br",
    "account_id": 1,
    "inbox_id": 7,
    "api_access_token": "****x9Qa",
    "enabled": true,
    "sign_messages": false,
    "reopen_conversation": true,
    "ignore_groups": true,
    "webhook_url": "https://api.flowbridge.com.br/v1/chatwoot/hooks/<token>",
    "last_error_code": null,
    "last_error_at": null,
    "created_at": "2026-10-01T12:00:00.000Z",
    "updated_at": "2026-10-01T12:00:00.000Z"
  }
}