Skills Development Handling Podium Webhooks Events

Handling Podium Webhooks Events

v20260423
podium-webhooks-events
This guide demonstrates how to implement a robust webhook handler for the Podium platform. Developers can process real-time business events—including incoming customer messages, new reviews, and completed payments—by setting up event routing and ensuring idempotent processing. Essential for integrating critical communication and transaction data into a backend system.
Get Skill
197 downloads
Overview

Podium Webhooks Events

Overview

Handle Podium webhook events for messages, reviews, and payments with event routing and idempotent processing.

Prerequisites

  • Podium OAuth tokens configured
  • HTTPS webhook endpoint

Instructions

Step 1: Webhook Event Types

EventDescription
message.receivedInbound customer message
message.sentOutbound message delivered
message.failedMessage delivery failed
review.createdNew review posted
payment.completedInvoice payment received

Step 2: Event Handler

import express from 'express';

const app = express();
app.post('/webhooks/podium', express.json(), async (req, res) => {
  const { type, data } = req.body;

  const handlers: Record<string, (data: any) => Promise<void>> = {
    'message.received': async (d) => {
      console.log(`Message from ${d.attributes['contact-phone']}: ${d.attributes.body}`);
    },
    'message.sent': async (d) => {
      console.log(`Message delivered: ${d.id}`);
    },
    'review.created': async (d) => {
      console.log(`New review: ${d.attributes.rating}/5`);
    },
    'payment.completed': async (d) => {
      console.log(`Payment received: $${d.attributes.amount / 100}`);
    },
  };

  const handler = handlers[type];
  if (handler) await handler(data);
  res.status(200).json({ received: true });
});

Step 3: Register Webhook

await podium.post('/webhooks', {
  data: {
    attributes: {
      url: 'https://your-app.com/webhooks/podium',
      events: ['message.received', 'message.sent', 'review.created', 'payment.completed'],
    },
  },
});

Output

  • Webhook endpoint handling all Podium event types
  • Event routing to specific handlers
  • Message, review, and payment events processed

Error Handling

IssueCauseSolution
No events receivedWrong URLVerify HTTPS URL in webhook config
Duplicate eventsRetry deliveryImplement idempotency with event IDs
Handler timeoutSlow processingOffload to background queue

Resources

Next Steps

For error diagnosis, see podium-common-errors.

Info
Category Development
Name podium-webhooks-events
Version v20260423
Size 2.79KB
Updated At 2026-04-28
Language