Package tracking
Turn any carrier tracking page into a webhook. Meerkat checks status on your schedule and notifies Rails when the shipment moves — no per-carrier SDK required.
When to use this
- Order tracking in a Rails commerce app
- Ops alerts when a package is out for delivery or delayed
- Carriers that only offer a public tracking URL
Implement in Rails
gem "meerkat-agents"
# bundle install
require "meerkat"
client = Meerkat::Client.new(api_key: ENV["MEERKAT_API_KEY"])
client.monitors.create(
description: "Monitor this shipment and report status changes",
input_params: {
courier_tracking_link: "https://www.dhl.de/track?id=..."
},
frequency: "every 2 hours",
output_webhook: "https://myapp.com/webhooks/meerkat"
)Update your order from the webhook
class Webhooks::MeerkatController < ApplicationController
include Meerkat::Rails::WebhookVerification
def create
payload = JSON.parse(request.raw_post)
Shipment.from_meerkat_event!(payload)
head :ok
end
end
Credits: each check consumes a run credit.
Use a frequency that matches how often status actually moves (every 1–4 hours is typical).
