# BuscarronThis page shows you how to set up Buscarron using Cinny client app (available as an add-on component).

## Overview

Buscarron is a Matrix bot developed by [etke.cc](https://etke.cc). It allows HTML [forms](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form) you add to your website (static or dynamic) to be submitted securely to a Matrix room of your choice. Submission happens via [HTTP POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) to a URL endpoint that the Buscarron bot exposes.

## Features

Here is a list of Buscarron’s main features:

- **Secure Communication**
  
  Buscarron ensures end-to-end encryption, providing a secure channel for data transmission and maintaining user privacy.
- **Form Submission Handling**
  
  Receive [HTTP POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) forms and JSON submissions within Matrix rooms, and then redirect successful and failed submissions to different target pages.
- **Spam prevention**
  
  Various spam prevention mechanisms are in place, starting from standard rate limiting and even doing SMTP validation on email fields in the form payload.
- **Customizable Matrix messages**
  
  Supporting [Go templates](https://pkg.go.dev/text/template) to define your own messages format
- **Confirmation emails using Postmark**
  
  The bot sends “Thank you!” message automatically ;)
- **Prometheus metrics**
  
  The bot exposes a [Prometheus](https://prometheus.io/)-compatible `/metrics` endpoint, protected with HTTP basic auth and an IP whitelist.

## Usage

To use the bot, start a chat with `@buscarron:your-server.com`. You can also add the bot to any existing Matrix room by inviting it to the room (`/invite @buscarron:your-server.com`).

**Make sure to replace `your-server.com` with your actual “base domain”.** Setting `your-server.com` or `example.com` does not work on your server!

![Invitation dialog](https://etke.cc/help/bots/buscarron/images/1.webp)

After the bot joins the room, anyone can call the web form via HTTP POST method.

Here is an example for the `contact` form:

```html
<form method="POST" action="https://buscarron.your-server.com/contact">

</form>
```


---
* [llms.txt](https://etke.cc/llms.txt): full site index in markdown