Agent skill

podium-core-workflow-b

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

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-b

SKILL.md

Podium Core Workflow B

Overview

Manage reviews and payments with Podium: request reviews from customers, track review status, and create payment invoices.

Prerequisites

  • Completed podium-core-workflow-a (messaging)
  • Reviews and Payments features enabled in Podium account

Instructions

Step 1: Request a Review

typescript
// Send a review request to a customer
const { data } = await podium.post(`/locations/${locationId}/review-invitations`, {
  data: {
    attributes: {
      'contact-phone': '+15551234567',
      'customer-name': 'Jane Doe',
    },
  },
});
console.log(`Review invitation sent: ${data.data.id}`);

Step 2: List Reviews

typescript
const { data } = await podium.get(`/locations/${locationId}/reviews`);
for (const review of data.data) {
  console.log(`  ${review.attributes.rating}/5 — ${review.attributes.body}`);
}

Step 3: Create a Payment Invoice

typescript
const { data } = await podium.post(`/locations/${locationId}/invoices`, {
  data: {
    attributes: {
      'contact-phone': '+15551234567',
      amount: 5000,  // $50.00 in cents
      description: 'Service invoice #1234',
    },
  },
});
console.log(`Invoice created: ${data.data.id}, amount: $${data.data.attributes.amount / 100}`);

Output

  • Review invitations sent to customers
  • Review listing with ratings and content
  • Payment invoices created and tracked

Error Handling

Error Cause Solution
422 Invalid amount Amount not in cents Convert dollars to cents (multiply by 100)
403 Payments not enabled Feature not active Enable Payments in Podium account
Review invitation failed Customer opted out Check contact preferences

Resources

Next Steps

Handle webhook events: podium-webhooks-events

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