dusk bot
integrationsread an invoice

dusk botintegrationsstripe

open the stripe invoice behind a billing question

answer the billing question with the actual bill in front of you. give the bot the customer and invoice context.

by the dusk bot team · checked · how we made this

it lists or searches stripe invoices, finds the match and opens the bill. if several fit, it asks you to choose. you get invoice details in chat while billing records and payments stay untouched.

pixel art: a green pixel bot and a mint pixel bot beside the Stripe mark on a white tile, a long receipt and a magnifying glass, on a lemon field in front of snowy hills and green fields, one saying "open the right invoice"

what it does

find the november bill before explaining the october one. one customer can have several invoices. a separate list or search finds the candidates; this action opens the one you choose. ask for the choices when the description fits more than one.

it can request linked details up to four levels deep. have it name what came back and leave missing details unknown.

when you would use it

  • explain an unfamiliar bill. read its details before answering the customer.
  • explain one invoice to a colleague. keep the findings in your chat.
  • confirm which bill the client meant. compare their description with the actual invoice.
  • prepare a billing answer. request supported linked customer details alongside the invoice.

try it

paste this into a chat with your bot

at noon each weekday, read emails from the last day that ask about an invoice. find the stripe invoice matching each sender and the bill they describe. ask me to choose if more than one fits.

read the matched invoice and report its status, amount and currency here. if a requested linked detail doesn't come back, say you don't know it. never send the invoice, contact the customer, edit billing records or take a payment.
when
weekdays at noon
needs
gmail and stripe both read only; email reads and invoice lookup and retrieval allowed

what comes back looks like this (an example)

rosewater print asks about its november bill

- matched invoice: rw-204
- status: open
- amount: 240 usd

ready to use when you write the customer reply.

set it up

  1. connect both sources for reading. gmail finds the question; stripe provides the bill.
  2. confirm a first match. describe the customer and billing context before opening the invoice.
  3. ask for the needed details. request related customer information too if it matters to the answer.
  4. compare the first answer with stripe. then schedule the daily review. use edit to narrow it if needed.

what it needs from you

inputrequiredwhat it is
invoiceyesThe unique identifier of the invoice to retrieve.
expandnoSpecifies which fields in the response should be expanded.

from composio's catalog for Stripe (action STRIPE_GET_INVOICES_INVOICE, read 12 november 20263). your bot fills these in from what you tell it.

how dusk bot handles it

dusk bot counts Retrieve Invoice as a read: it looks and changes nothing. a bot you allow only to read can use it.

the permissions Stripe asks for to run it: read_only.

where it stops

  • retrieval opens one invoice. another lookup finds it first. an unclear customer name is not enough.
  • linked reads stop at four levels. if a detail does not return, the bot should say it does not know.
  • search can lag behind new bills. usually within a minute; outages can delay it up to an hour. try listing fresh invoices instead.
  • local routines need an awake computer. a run under 12 hours late runs once on return. older runs skip; dusk cloud runs on time.

try it in 2 minutes

  1. pick one recent billing email
  2. ask the bot to find matching stripe invoices
  3. confirm the customer and bill
  4. ask for status, amount and currency, without sending

mistakes people make

picking the first bill for that customer

match the bill in the email. ask when several invoices fit.

inventing a missing linked detail

say it is unknown. request the needed detail separately if the connection supports it.

questions

can it find the invoice if i only know the customer?

it can find candidates. list or search finds the bills; retrieval opens the right one. have it ask when several fit.

will opening an invoice email it to the customer?

no. this only reads. sending an invoice is another action, outside this routine.

search may not have caught up. try listing invoices, then confirm the match before opening the bill.

sources

  1. dusk bot docs: files and apps
  2. dusk bot docs: routines
  3. composio, Stripe toolkit (catalog version 20261101_00), checked 12 november 2026

drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].