Rivelko Integration Guide

Guia de integracion para desarrolladores / Developer integration guide

Rivelko is a SaaS platform for AI-powered conversational and classic forms. Embed an intelligent form widget on your website in minutes -- or build a fully custom integration using our public API.

Quick Start

1. Create and publish a form

Log in to the Rivelko dashboard, create a form (or let AI generate one), and publish it. Make sure to add your domain to the Allowed Domains list in the form settings.

2. Embed the widget

Add this script tag to your website, right before </body>:

<script
  src="https://app.rivelko.com/api/widget"
  data-form-id="YOUR_FORM_ID"
></script>

That's it. The widget loads the form, renders a floating bubble, and handles the entire interaction -- chat or classic form. It uses Shadow DOM, so it won't conflict with your styles.

3. Receive data via webhooks (optional)

Want to get notified when someone completes a form? Set up a webhook in the form settings to receive a POST request with the collected data. See the Webhook Guide.

How It Works

Your Website                    Rivelko
-----------                    ----------
  <script>  ──── loads ────>  GET /api/widget        (JS bundle)
  Widget    ──── fetches ──>  GET /api/forms/:id/config  (form config)
  Widget    <─── renders ───  Chat bubble or classic form

  Visitor types ── sends ──>  POST /api/chat         (conversational)
                    or        POST /api/forms/:id/submit  (classic)

  Form completed ── fires ─>  POST your-webhook-url  (collected data)

Base URL

https://app.rivelko.com

For local development: http://localhost:3000

Plan Limits

Documentation

Need help?

• Dashboard: app.rivelko.com
• Issues: github.com/raymardev/rivelko/issues