Agent skill

podium-core-workflow-a

Podium core workflow a — business messaging and communication platform integration. Use when working with Podium API for messaging, reviews, or payments. Trigger with phrases like "podium core workflow a", "podium-core-workflow-a".

Stars 1,803
Forks 241

Install this agent skill to your Project

npx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/main/plugins/saas-packs/podium-pack/skills/podium-core-workflow-a

SKILL.md

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

Next Steps

Reviews and payments: podium-core-workflow-b

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results