Payments
Verified by Toolspoke

PayPal dispute watcher

By Toolspoke

Lists open PayPal disputes each weekday, sorted by response deadline with amount and reason, and posts them to Slack.

Needs a Toolspoke account. You choose which project it installs into.

An illustration with made-up examples. It is not a recording.
PayPal + Slack
Required integrations
Runs on a schedule
Weekdays at 10am by default
Post one message
What its last step does
Some actions can delete
5 of 36 actions in its tools
On this page
  1. The short version
  2. What it will never do
  3. What PayPal dispute watcher does
  4. How it works
  5. What a weekday message looks like
  6. Who uses PayPal dispute watcher
  7. What it connects to
  8. When it runs
  9. How to set it up
  10. Make PayPal dispute watcher fit your team
  11. Compared with other options
  12. Questions
  13. Related agents

The short version

What it is
A ready-made Toolspoke agent that tells your team each weekday which PayPal disputes need an answer, and by when.
What it reads
Every open dispute, with its amount, reason, stage and the date PayPal needs a response by.
Where it posts
One Slack channel, chosen when you set it up.
How it sorts
Needs a response (nearest deadline first), waiting on the buyer or PayPal, and new since the last run.
How often
Weekdays at 10am once you switch it on. If there are no open disputes it posts nothing.
What it never does
Respond to, accept, escalate or settle a dispute, or refund anyone.
What you need
A Toolspoke account, a PayPal REST app and a Slack workspace.

What PayPal dispute watcher will never do

PayPal dispute watcher cannot answer a dispute, and it is told never to refund anyone or post a buyer's details. It tells you what is due, and a person replies.

PayPal dispute watcher will never

  • Respond to, accept, escalate or offer to settle a dispute.
  • Refund a capture, capture an order, or send or cancel an invoice.
  • Post the buyer's email address, shipping address or the messages they wrote to Slack.
  • Add two currencies together.

Why it never answers

A dispute answer is evidence in a case, and accepting one gives the money back. Both are decisions that need someone who knows the order, and the PayPal connection has no action for either.

What it keeps out of Slack

A dispute often contains a buyer's address and their own words. The post uses the dispute id and links to PayPal for the rest.

A message that leaksClaim from [email protected], 4 Birch Lane: 'Never arrived, I want my money back now.'
What this agent writes insteadPP-D-48213, 129.00 USD, item not received, claim. 1 day left.

Why you may still want a lock

The connection can refund. Allow this agent PayPal reads only, and refunding is impossible for it.

These are written into PayPal dispute watcher's instructions. They guide the agent, but they are not a permission. What it is allowed to touch is set by the access you grant.

PayPal dispute watcher reads PayPal and reports deadlines. Every answer to a dispute, and every refund, is a person's.

What PayPal dispute watcher does

PayPal dispute watcher is an AI agent that reads your open PayPal disputes every weekday morning and posts one Slack message with the nearest response deadline first, so nobody loses a case by missing the date.

A PayPal dispute has a deadline, and a seller who misses it usually loses the money by default. PayPal emails about each one, and those emails are easy to lose among everything else.

PayPal dispute watcher reads every dispute that is still open, looks up each one's amount, reason, stage and response date, and sorts them so the most urgent is at the top. Anyone due within two days is flagged, and the person you chose is mentioned.

It never answers a dispute. The PayPal connection has no action that can respond to, accept or settle one, so what to say, and whether to fight, stays with a person.

In practice, on a weekday morning you get one message, or nothing:

  • Every dispute waiting on you, nearest deadline first
  • How many days are left on each, with any under two flagged
  • Disputes waiting on the buyer or under PayPal review
  • Disputes opened since the last run

How it works

PayPal dispute watcher works in four steps each weekday: it lists the open disputes, reads each one, sorts them by deadline and posts one message. All of it comes from the agent's written instructions, which you can read and edit after you install it.

  1. Step 1: List open disputes

    Waiting on you, waiting on the buyer, and under review.

  2. Step 2: Read each one

    Amount, reason, stage and the response deadline.

  3. Step 3: Sort by deadline

    The nearest first, with two days or less flagged.

  4. Step 4: Post one message

    Needs a response, then waiting, then new.

Drawn from this agent's own tools and instructions. It is not a recording of a run.

It reads every open state

It calls list_disputes with dispute_state set to REQUIRED_ACTION, which is waiting on you, then REQUIRED_OTHER_PARTY_ACTION and UNDER_PAYPAL_REVIEW, so nothing open is missed.

It reads the deadline from PayPal

It calls get_dispute for each one, for the amount and currency, the reason, whether it is an inquiry, a claim or a chargeback, and the date PayPal needs a response by. It does not guess a deadline.

It flags what is close

A dispute due within two days is marked, and the person you chose at install is mentioned on it, so the urgent ones are seen first.

It keeps buyers out of Slack

It uses the dispute id and links to PayPal. It never posts the buyer's email, address or messages. The limits are listed under what it will never do.

What a weekday message looks like

A message from PayPal dispute watcher is a single Slack post. Disputes waiting on you come first, nearest deadline at the top.

Wildfern

Channels

  • # disputes
  • # orders
  • # support
  • # general

# disputes

PayPal dispute watcherAPP10:00 AM

Wednesday. 6 open disputes, 488.49 USD and 58.00 GBP in all.

Needs a response (3)

  • PP-D-48213, 129.00 USD, item not received, claim. Respond by Thursday, 1 day left. @rosa
  • PP-D-48190, 64.50 USD, not as described, inquiry. Respond by 4 November, 4 days left.
  • PP-D-48177, 58.00 GBP, unauthorised, chargeback. Respond by 7 November, 7 days left.

Waiting on the buyer or PayPal (3)

  • PP-D-48102, 39.99 USD, waiting on the buyer until 3 November.
  • PP-D-47988, 210.00 USD, under PayPal review.
  • PP-D-47950, 45.00 USD, waiting on the buyer until 6 November.

New since yesterday (1)

PP-D-48213, opened Tuesday.

One message, posted on Wednesday at 10:00 AM. The disputes and amounts are made up.
Needs a response

Disputes waiting on you, nearest deadline first, with the days left. Two days or less is flagged and the person you chose is mentioned.

Waiting

Disputes waiting on the buyer or under PayPal review. Nothing to do yet, but they can come back.

New

Disputes opened since the last run, so a new one is seen the day it arrives.

Why it sometimes says nothing

If there are no open disputes, PayPal dispute watcher posts nothing. A daily all clear teaches people to skip the channel.

A failed run is different. If PayPal cannot be read, it posts that once, because a quiet channel on the day a deadline falls is exactly what it exists to prevent.

Who uses PayPal dispute watcher

PayPal dispute watcher suits any business that takes PayPal payments and has missed, or nearly missed, a dispute deadline. The examples use made-up names.

An online shop owner

Rosa Jimenez sells handmade goods and lost a claim last year by not answering in time. Now the urgent one is at the top of the channel with her name on it.

In their messageNeeds youPP-D-48213, 129.00 USD, item not received. 1 day left.

A support lead who gathers evidence

Ali Hassan pulls tracking numbers and messages for each case. The reason and stage tell him what evidence each one needs.

In their messageWorth knowingPP-D-48190, 64.50 USD, not as described, inquiry.

A finance lead tracking exposure

Ingrid Larsen wants to know how much money is in dispute. The total per currency is at the top of every post.

In their messageWorth knowing6 open disputes, 488.49 USD and 58.00 GBP in all.

A small team sharing the PayPal login

Ben Carter's team used to assume someone else had seen the email. The channel makes it obvious who is on each case.

In their messageNeeds youPP-D-48177, 58.00 GBP, chargeback. 7 days left.

What PayPal dispute watcher connects to

PayPal dispute watcher connects to two tools: it reads PayPal and posts to Slack. You connect each one yourself, and Toolspoke stores the connection encrypted, so the agent never sees the credential.

  • PayPal

    Required

    Read transactions, balances and disputes, manage invoices and orders, and issue refunds.

    Authentication: REST app client credentials

    View integration for PayPal

  • Slack

    Required

    Search conversations and send messages to your workspace.

    Authentication: Bot token

    View integration for Slack

What PayPal dispute watcher does and cannot do in each connected tool
ToolWhat PayPal dispute watcher doesWhat it cannot do
PayPalReads open disputes and the detail of each (list_disputes, get_dispute).Respond to, accept, escalate or settle a dispute: the connector has no action for any of them. It can refund a capture and send or cancel an invoice, and this agent's instructions forbid all of those.
SlackPosts one message with send_message, to a channel.Delete messages: the connector has no delete action.

The PayPal connection cannot answer a dispute, which is a property of the connector. Whatever happens, the reply to a buyer is written by a person in PayPal.

The PayPal connection can move money: refunding and capturing are destructive actions. PayPal dispute watcher is told never to use them, and that is an instruction. To make it a lock, allow this agent PayPal reads only in your project. The access control guide explains how.

The activity log records each call, but PayPal dispute reads keep only that the call happened. The message posted to Slack is stored.

When PayPal dispute watcher runs

PayPal dispute watcher runs every weekday at 10am, but only after you switch its schedule on. It arrives switched off, so nothing runs and nothing is charged until you decide.

  • Each run reads every open dispute.
  • When there are none, it posts nothing.
  • A deadline within two days is always flagged.
  • If PayPal cannot be read, it posts that once.

Each run uses model credit from your workspace balance, even when nothing is posted, so it makes five runs a week. The PayPal and Slack calls themselves are free.

Your copy is an ordinary agent in your project. You can pause its schedule there, run it once on demand, change the days and time and edit its instructions. The agent's page lists recent runs and their cost.

How to set up PayPal dispute watcher

To hear about dispute deadlines every weekday, add PayPal dispute watcher to a Toolspoke project, connect PayPal and Slack, allow PayPal reads only and switch on the schedule. It takes a few minutes, and nothing runs until the last step.

  1. Step 1: Create a Toolspoke account or sign in

    Choose Use this agent. If you are new, you will be asked to sign up first, and you come straight back to this agent afterwards.

  2. Step 2: Add it to a project

    Pick the project it should live in. You get your own editable copy, and you can see the two tools it brings before anything connects.

  3. Step 3: Connect PayPal

    In the PayPal Developer Dashboard, open or create a live REST app and paste its client id and secret. They are stored encrypted and the agent never sees them.

  4. Step 4: Allow PayPal reads only

    In the project's access settings, allow this agent reads only on PayPal, so refunds and invoices are out of reach.

  5. Step 5: Connect Slack

    Choose Sign in with Slack and approve the Toolspoke app. For a private channel, add the Toolspoke bot to it first.

  6. Step 6: Choose the channel and who to mention

    Name the channel in the instructions, and the person to mention when a deadline is close.

  7. Step 7: Switch on the schedule

    The schedule arrives switched off. Run it once to see a message, then switch it on.

Make PayPal dispute watcher fit your team

PayPal dispute watcher's instructions are plain English and you can edit them after you install it. Installing copies the agent, so your edits stay with your copy. Open the agent in Toolspoke and tell the builder what to change, and it rewrites the instructions.

Paste any sentence below into the builder chat, or say the same thing in your own words.

Flag earlier
Flag any dispute due within four days, not two.
Leave out the waiting ones
Only list disputes that need a response from us.
Run at weekends too
Run every day at 10am, including weekends.

This changes when the agent wakes up, so the builder edits its schedule, not the instructions.

Mention by reason
Mention @ali on item not received disputes and @rosa on everything else.
Show the order date
Add the date of the original payment to each dispute.

None of these edits needs more access or touches the Never rules. They change what PayPal dispute watcher is told, not what the connections allow.

How it compares to other options

PayPal dispute watcher beats the alternatives when you want every open dispute sorted by deadline in the channel your team reads, and loses to them when you want disputes answered for you.

PayPal dispute watcher compared with PayPal's emails, PayPal's Resolution Center, A chargeback service
Compared onPayPal dispute watcherPayPal's emailsPayPal's Resolution CenterA chargeback service
Every open dispute in one messageYesOne email eachYes, if you log inYes, in its dashboard
Sorted by response deadlineYesNoIf you sort itUsually
Arrives where the team talksYes, in SlackEmail onlyNoDepends
Answers disputes for youNo, a person doesNoYou answer thereYes
Can refund or acceptCannot accept; allow reads onlyNoYesDepends on the service
Setup effortConnect two accountsNoneNoneA contract and setup

PayPal's Resolution Center is where disputes are answered, and it stays that way. PayPal dispute watcher makes sure someone opens it in time.

A chargeback service is better at high volume, when you want evidence gathered and submitted for you. PayPal dispute watcher suits a business that answers its own disputes and only needs to see them in time.

Frequently asked questions

Can PayPal dispute watcher respond to or accept a dispute?

No. The PayPal connector has no action that responds to, accepts, escalates or settles a dispute, so the connection cannot.

Can it refund a buyer?

It is told never to. The PayPal connection can refund a capture, so allow this agent PayPal reads only in your project if you want that enforced (how access works).

Where does the deadline come from?

From PayPal. The agent reads each dispute with get_dispute and uses the response date PayPal records. It never works one out.

Does it include inquiries as well as claims?

Yes. Every open dispute is listed with its stage: inquiry, claim or chargeback.

Does it post buyer details to Slack?

No. It uses the dispute id, amount, reason and deadline, and never posts the buyer's email, address or messages.

Why did it post nothing today?

There were no open disputes. If PayPal could not be read, it would have said so.

Is PayPal dispute watcher free?

It has no price of its own, and every Toolspoke plan includes agents. Tool calls cost nothing, but each run draws on your usage balance. Pricing has the details.

Never miss a dispute deadline again

Connect PayPal and Slack, allow PayPal reads only, choose the channel and switch on the schedule. Your first message lands on the next weekday at 10am.