Podium Core Workflow A

---
name: podium-core-workflow-a
description: "Podium core workflow a \u2014 business messaging and communication platform\
  \ integration.\nUse when working with Podium API for messaging, reviews, or payments.\n\
  Trigger with phrases like \"podium core workflow a\", \"podium-core-workflow-a\"\
  .\n"
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep
version: 2.0.0
license: MIT
tags:
- saas
- podium
- messaging
- reviews
- payments
compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
---
# Podium Core Workflow A

## Overview
Build a complete messaging workflow with Podium: send messages, receive inbound messages via webhooks, and manage conversation threads.

## Prerequisites
- Completed `podium-install-auth` with OAuth tokens
- Webhook endpoint accessible via HTTPS

## Instructions

### Step 1: Set Up Webhook for Inbound Messages
```typescript
import express from 'express';
const app = express();

app.post('/webhooks/podium', express.json(), async (req, res) => {
  const event = req.body;
  if (event.type === 'message.received') {
    const msg = event.data;
    console.log(`From: ${msg.attributes['contact-phone']}`);
    console.log(`Body: ${msg.attributes.body}`);
    // Auto-reply or route to agent
    await sendReply(msg.attributes['location-uid'], msg.attributes['contact-phone'], 'Thanks for reaching out!');
  }
  res.status(200).json({ received: true });
});
```

### Step 2: Register Webhook with Podium
```typescript
const { data } = await podium.post('/webhooks', {
  data: {
    attributes: {
      url: 'https://your-app.com/webhooks/podium',
      events: ['message.received', 'message.sent', 'message.failed'],
    },
  },
});
console.log(`Webhook registered: ${data.data.id}`);
```

### Step 3: Send Reply Messages
```typescript
async function sendReply(locationId: string, phone: string, body: string) {
  const { data } = await podium.post(`/locations/${locationId}/messages`, {
    data: { attributes: { body, 'contact-phone': phone } },
  });
  return data.data.id;
}
```

## Output
- Webhook receiving inbound messages
- Auto-reply capability
- Two-way messaging via Podium

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| Webhook not firing | URL not HTTPS | Use HTTPS endpoint |
| Message failed | Invalid phone | Verify E.164 format |
| No events received | Wrong event types | Check webhook configuration |

## Resources
- [Sync Messages](https://docs.podium.com/docs/sync-messages-from-podium-conversations)
- [Webhooks Guide](https://docs.podium.com/docs/webhooks)

## Next Steps
Reviews and payments: `podium-core-workflow-b`