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.
- 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
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.
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.
Step 1: List open disputes
Waiting on you, waiting on the buyer, and under review.
Step 2: Read each one
Amount, reason, stage and the response deadline.
Step 3: Sort by deadline
The nearest first, with two days or less flagged.
Step 4: Post one message
Needs a response, then waiting, then new.
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
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.
- 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.
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.
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.
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.
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
RequiredRead transactions, balances and disputes, manage invoices and orders, and issue refunds.
Authentication: REST app client credentials
Slack
RequiredSearch conversations and send messages to your workspace.
Authentication: Bot token
| Tool | What PayPal dispute watcher does | What it cannot do |
|---|---|---|
| PayPal | Reads 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. |
| Slack | Posts 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.
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.
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.
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.
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.
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.
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.
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 any dispute due within four days, not two.
Only list disputes that need a response from us.
Run every day at 10am, including weekends.
This changes when the agent wakes up, so the builder edits its schedule, not the instructions.
Mention @ali on item not received disputes and @rosa on everything else.
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.
| Compared on | PayPal dispute watcher | PayPal's emails | PayPal's Resolution Center | A chargeback service |
|---|---|---|---|---|
| Every open dispute in one message | Yes | One email each | Yes, if you log in | Yes, in its dashboard |
| Sorted by response deadline | Yes | No | If you sort it | Usually |
| Arrives where the team talks | Yes, in Slack | Email only | No | Depends |
| Answers disputes for you | No, a person does | No | You answer there | Yes |
| Can refund or accept | Cannot accept; allow reads only | No | Yes | Depends on the service |
| Setup effort | Connect two accounts | None | None | A 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.