Webhook Payload

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "pool_number_id",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "+15551234567",
              "phone_number_id": "pool_number_id"
            },
            "messages": [
              {
                "id": "msg_abc123",
                "from": "15559876543",
                "timestamp": "2025-01-15T10:30:00.000Z",
                "type": "text",
                "text": {
                  "body": "Hello from WhatsApp!"
                }
              }
            ],
            "contacts": [
              {
                "profile": {
                  "name": "Jane Doe"
                },
                "wa_id": "15559876543"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ],
  "pipes": {
    "conversationId": "conv_xyz789",
    "poolNumberId": "pool_number_id",
    "label": "support"
  }
}

{
  "type": "text",
  "text": {
    "body": "Hello from WhatsApp!"
  }
}

{
  "type": "image",
  "image": {
    "id": "media_id",
    "mime_type": "image/jpeg",
    "caption": "Check this out"
  }
}

{
  "pipes": {
    "conversationId": "conv_xyz789",
    "poolNumberId": "pool_number_id",
    "media": {
      "mediaId": "aBcDeFgHiJkLmNoPqRs1t",
      "downloadUrl": "/v1/media/download/aBcDeFgHiJkLmNoPqRs1t",
      "mimeType": "image/jpeg",
      "byteSize": 245120
    }
  }
}

{
  "type": "audio",
  "audio": {
    "id": "media_id",
    "mime_type": "audio/ogg"
  }
}

{
  "type": "video",
  "video": {
    "id": "media_id",
    "mime_type": "video/mp4",
    "caption": "Watch this"
  }
}

{
  "type": "document",
  "document": {
    "id": "media_id",
    "mime_type": "application/pdf",
    "filename": "invoice.pdf",
    "caption": "Here's the invoice"
  }
}

{
  "type": "sticker",
  "sticker": {
    "id": "media_id",
    "mime_type": "image/webp"
  }
}

{
  "type": "location",
  "location": {
    "latitude": 37.7749,
    "longitude": -122.4194,
    "name": "San Francisco",
    "address": "San Francisco, CA, USA"
  }
}

{
  "type": "contacts",
  "contacts": [
    {
      "name": { "formatted_name": "Jane Doe" },
      "phones": [{ "phone": "+15559876543", "type": "CELL" }]
    }
  ]
}

{
  "type": "reaction",
  "reaction": {
    "message_id": "msg_original123",
    "emoji": "👍"
  }
}

{
  "type": "button",
  "button": {
    "text": "Confirm",
    "payload": "confirm_order"
  }
}

{
  "type": "interactive",
  "interactive": {
    "type": "button_reply",
    "button_reply": { "id": "confirm", "title": "Confirm" }
  }
}

{
  "type": "order",
  "text": { "body": "" }
}

{
  "messages": [
    {
      "id": "wamid.abc123",
      "from": "US.13491208655302741918",
      "timestamp": "2025-01-15T10:30:00.000Z",
      "type": "text",
      "text": { "body": "Hello" }
    }
  ],
  "contacts": [
    {
      "profile": { "name": "Jane Doe", "username": "@jane" },
      "wa_id": "US.13491208655302741918",
      "user_id": "US.13491208655302741918"
    }
  ]
}

{
  "id": "evt_3f9c1a7b2d4e4f6a8b0c1d2e3f4a5b6c",
  "field": "messages",
  "createdAt": "2025-01-15T10:30:01.123Z",
  "pipes": {
    "appId": "app_abc123",
    "poolNumberId": "pn_abc123",
    "media": {
      "1234567890": {
        "mediaId": "aBcDeFgHiJkLmNoPqRs1t",
        "downloadUrl": "/v1/media/download/aBcDeFgHiJkLmNoPqRs1t",
        "mimeType": "image/jpeg",
        "byteSize": 48213
      }
    }
  },
  "whatsapp": {
    "messaging_product": "whatsapp",
    "metadata": { "display_phone_number": "15551234567", "phone_number_id": "1098765432" },
    "contacts": [{ "profile": { "name": "Jane Doe" }, "wa_id": "15559876543" }],
    "messages": [
      {
        "from": "15559876543",
        "id": "wamid.abc123",
        "timestamp": "1736937000",
        "type": "image",
        "image": { "id": "1234567890", "mime_type": "image/jpeg" }
      }
    ]
  }
}

{
  "test": true,
  "source": "pipes.bot"
}

{
  "event": "test",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "app": { "id": "app_abc123", "name": "My App" },
  "message": "This is a test webhook from Pipes.bot"
}

app.post("/webhook", (req, res) => {
  const payload = req.body;

  if (payload.test === true || payload.event === "test") {
    // Test ping — acknowledge without processing
    return res.sendStatus(200);
  }

  // Process real message...
});

app.post("/webhook", (req, res) => {
  const payload = req.body;

  if (payload.test === true) {
    return res.sendStatus(200);
  }

  const message = payload.entry[0].changes[0].value.messages[0];
  const pipes = payload.pipes;

  switch (message.type) {
    case "text":
      console.log("Text:", message.text.body);
      break;

    case "image":
    case "audio":
    case "video":
    case "document":
    case "sticker":
      if (pipes.media?.unavailable) {
        console.log("Media unavailable for this message");
      } else {
        console.log("Download from:", pipes.media.downloadUrl);
        console.log("MIME type:", pipes.media.mimeType);
        console.log("Size:", pipes.media.byteSize, "bytes");
      }
      break;

    case "location":
      console.log("Location:", message.location.latitude, message.location.longitude);
      break;

    case "contacts":
      console.log("Contacts:", message.contacts);
      break;

    case "reaction":
      console.log("Reaction:", message.reaction.emoji, "on", message.reaction.message_id);
      break;

    case "button":
      console.log("Button tapped:", message.button.text);
      break;

    case "interactive":
      console.log("Interactive reply:", message.interactive.type);
      break;

    default:
      // order, system, unknown, future Meta types — type string preserved
      console.log("Other type:", message.type);
  }

  res.sendStatus(200);
});