# Send a fax from Botpress

> A Botpress bot can send and read faxes through the Fax for Agents integration. You install the integration in the bot and give an Autonomous Node the fax tools.

Page: https://faxforagents.com/docs/guides/botpress/
Last changed: 2026-11-07

Updated Nov 7, 2026

A Botpress bot can send and read faxes through the Fax for Agents integration. You install the integration in the bot and give an Autonomous Node the fax tools. The bot then prepares, quotes and sends the fax in one turn. By default it sends inside the limits your organization set, with no approval per fax. This guide was recorded in Sandbox mode, so nothing reached a real fax line.

Screenshots taken on Nov 7, 2026.

## Before you start

- A Fax for Agents account. The dashboard is at app.faxforagents.com.
- A Sandbox API key from the dashboard, under API keys. Tick "This key is for a connected app such as Gemini CLI" when you create it, so the Connected apps setting covers the bot.
- A Botpress workspace with the Fax for Agents integration available. Until the Hub listing is verified, the integration is deployed privately in the workspace.
- The Connected apps switch in Settings is on by default. The default limits are $5.00 per fax and 20 faxes a day.

## 1.Open the Integration Hub

Open your bot in the Botpress Studio and select Integration Hub at the top. Search for fax.

Select Integration Hub, search for fax and open Fax for Agents.

## 2.Install the integration

The integration page lists every action. Select Install Integration.

Select Install Integration. The integration is added to this bot.

## 3.Enter the API key

The configuration form asks for the API key. Paste the Sandbox key and leave Sandbox ticked. Select Save Configuration. The integration checks the key and enables itself.

Paste your Sandbox key, keep Sandbox ticked and select Save Configuration.

## 4.Add the fax tools

Select the Autonomous Node in the Main workflow. Under Tools, select Add Tool and add Prepare Fax, Quote Fax, Send Fax, Get Fax Status, List Inbox and Read Inbound Fax.

Add the fax tools to the Autonomous Node. The node calls them in the order the instructions say.

## 5.Write the instructions

Open Instructions on the node and describe the routine. Prepare Fax first, then Quote Fax with the number, then Send Fax with the quote id, then Get Fax Status.

Tell the node which tool to call when. Short plain sentences work.

## 6.Send a fax

In the Emulator, type what the fax should say and where it goes, and say send. The bot prepares the document, quotes it and sends it, then reports the status.

Describe the fax and say send. The bot prepares it, quotes it and sends it, with no approval.

## 7.Check the evidence

Ask for the delivery evidence. The bot calls Get Fax Status and reports the state, the pages and the attempt.

Ask for the delivery evidence to see the state and the attempt details.

## 8.Read the inbox

Ask for the inbox. The bot calls List Inbox and Read Inbound Fax and reads the newest fax.

Ask for your inbox. The bot lists the received faxes and reads the newest one.

## What the limits mean

Open Settings in the dashboard. The Connected apps card holds the switch "Let connected apps send without asking". Under it are two fields, "Amount per fax, at most" ($5.00) and "Faxes per day" (20). A bot that uses a connected-app credential sends inside these limits with no approval per fax. Turn the switch off and every send waits for a person. Finer limits, such as destinations or one app only, live under Policies. See the guide [Your assistant sends within limits by default](https://faxforagents.com/docs/guides/auto-send-switch/).

## Approve every fax instead

1. In Settings, turn off "Let connected apps send without asking" and choose Save.
2. Give the node Request Human Review and Get Review Status instead of Send Fax. The bot quotes the fax and asks a person.
3. A person approves in the dashboard. The bot reads the approval with Get Review Status and sends with Send Approved Fax.

The example bot in the integration's repository shows this routine in code.

## Troubleshooting

- Save Configuration fails with an environment or token message. The key is a Live key with Sandbox ticked, or the key was revoked. Use a Sandbox key, the kind the dashboard marks as test.
- The bot answers that the fax is queued. Sandbox delivery takes a few seconds. Ask for the status again, and the bot reports delivered.
- Send Fax answers that an approval is required. An owner turned the Connected apps switch off, or the fax is above a limit. Check Settings, Connected apps for your environment.
- The Integration Hub shows no results. Remove the Made by Botpress and Verified by Botpress filters. A private integration only appears without them.

## Next

- [Quickstart](https://faxforagents.com/docs/quickstart/)
- [Dashboard](https://app.faxforagents.com/)
- [Pricing](https://faxforagents.com/pricing/)