Criar um flow | Muchaw DEV

curl -X POST https://dev.muchau.com.br/api/flows/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "numberId": "whatsapp-number-12345",
  "name": "Customer Support Flow",
  "categories": [
    "CONTACT_US"
  ],
  "publicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv1X9Zb1k5v+2Q9J6X9qF\n3v1Zx9Q+7v1X9Zb1k5v+2Q9J6X9qF3v1Zx9Q+7v1X9Zb1k5v+2Q9J6X9qF3v1Zx9\nQ+7v1X9Zb1k5v+2Q9J6X9qF3v1Zx9Q+7v1X9Zb1k5v+",
  "endpointUrl": "https://api.example.com/flows/customer-support"
}'

{
  "id": "flow-98765",
  "developerId": "dev-1234567890abcdef",
  "wabaId": "waba-54321",
  "metaFlowId": "meta-flow-112233",
  "name": "Customer Support Flow",
  "status": "DRAFT",
  "categories": [
    "CONTACT_US"
  ],
  "jsonVersion": "1.0.0",
  "endpointUrl": "https://api.example.com/flows/customer-support",
  "publicKeyConfigured": true,
  "createdAt": "2024-06-01T10:15:30Z",
  "updatedAt": "2024-06-01T10:15:30Z"
}

Cria um novo WhatsApp Flow.

Authentication

AuthorizationBearer

API Key in the format mk_live_<43-chars>. Obtain from the Dashboard or POST /auth/api-keys.

Request

This endpoint expects an object.

numberIdstringRequired

WhatsApp Number ID to create the flow under

namestringRequired>=1 character

Display name for the flow

categorieslist of stringsRequired

Flow categories (e.g., SIGN_UP, SIGN_IN, CONTACT_US, OTHER)

publicKeystringRequiredformat: "^-----BEGIN PUBLIC KEY-----.*"

PEM-encoded RSA 2048 public key for flow data exchange encryption

endpointUrlstringRequiredformat: "uri"

HTTPS endpoint URL where data exchange requests will be forwarded

Response

Default Response

idstring

Unique identifier of the flow in the Muchaw platform

developerIdstring

ID of the developer who owns this flow

wabaIdstring

WhatsApp Business Account ID this flow belongs to

metaFlowIdstring

Flow ID assigned by Meta

namestring

Flow name

statusenum

Current lifecycle status of the flow

categorieslist of strings

Flow categories

jsonVersionstring or null

Version of the flow JSON spec

endpointUrlstring or null

HTTPS endpoint URL for data exchange

publicKeyConfiguredboolean

Whether a public key is configured for this flow

createdAtstring

ISO 8601 datetime when the flow was created

updatedAtstring

ISO 8601 datetime when the flow was last updated

Errors

400

Bad Request Error

401

Unauthorized Error