Skip to content

๐Ÿงพ Custom Form Action โ€‹

Custom Form actions allow your AI assistant to show a fully customizable form inside the chat interface.
Theyโ€™re perfect for collecting user data (like contact details, feedback, or demo requests) and optionally sending that data to a webhook or automation tool.


๐Ÿงญ Overview โ€‹

You can create any kind of form with multiple fields such as name, email, phone, or message.
Once the user fills it, the data can be:

  • Stored in Ainisa for internal use
  • Sent via webhook to your own backend or CRM
  • Used to trigger external automations (like n8n or Zapier)

โš™๏ธ How to Create a Custom Form Action โ€‹

Go to
Business Dashboard โ†’ AI Assistants โ†’ AI Actions โ†’ Create Action

Then choose
Action Type: Custom Form


๐Ÿ–ผ Custom Form โ€‹

Create Action โ€“ Custom Form


๐Ÿงฑ Main Fields โ€‹

FieldDescription
Action NameThe name of your form (for example, โ€œContact Us Formโ€).
When To UseShort text for AI to understand when to show this form. Example: โ€œUse this action when user wants to contact us.โ€
Form FieldsAdd and customize available fields: Firstname, Lastname, Email, Phone, Message, etc. Each field can be toggled on/off, marked as required, and given a custom label or placeholder.
Has Call To Action (CTA)Optional text or link shown after the form submission. Examples: โ€œGet coupon codeโ€ or โ€œOpen special offerโ€.
Webhook URL(Optional) If set, form data will be sent as a POST request in JSON format to your provided webhook URL.
EnabledToggles the action on or off.

๐Ÿ’ก Example Configuration โ€‹

FieldExample
Action NameContact Form
When To UseUse this form when the user wants to contact our sales team
Fields EnabledFirstname, Lastname, Email, Phone
Has Call To Actionโœ… Yes
CTA TypeText
CTA LabelGet coupon code
CTA TextAINISA2025
Webhook URLhttps://example.com/api/webhooks/contacts
Enabledโœ…

๐Ÿง  Call To Action (CTA) โ€‹

After a user submits a form, you can show a Call To Action (CTA) section.
This CTA can have two types:

TypeDescriptionExample
TextDisplays static text after submission, such as a coupon or promo code.Label: Get coupon code โ€” Text: AINISA2025
LinkDisplays a clickable button with a link.Label: View Offer โ€” URL: https://ainisa.com/en/pricing

๐Ÿช„ Webhook Integration โ€‹

If you provide a Webhook URL, Ainisa will automatically send a POST request to that URL after a form is submitted.

Example request body:

json
{  
"firstname": "Javid",  
"lastname": "Aliyev",  
"phone": "+994501234567",  
"email": "javid@ainisa.com",
"timestamp": "2025-11-05T01:08:00Z"  
}

Use this data to trigger workflows, store leads, or forward messages to your CRM or automation tools like n8n, Make, or Airtable.


๐Ÿ’ฌ Example in Chat โ€‹

When a user asks:

โ€œI want to contact your team.โ€

The AI will display your configured form directly in chat:

  • Fields for Firstname, Lastname, Phone, and Email
  • A submit button
  • (Optional) CTA shown after submission, e.g., โ€œโœ… Thank you! Your coupon code: AINISA2025โ€

๐Ÿ–ผ Enable and add CTA โ€‹

Form with CTA and Webhook Settings


๐Ÿ’ผ Example Use Cases โ€‹

Here are some practical examples of how businesses use Custom Form actions inside Ainisa:

1. ๐Ÿงพ Lead Collection โ€‹

Businesses can collect user contact details when a visitor asks for more info.
Example:
User says: โ€œIโ€™m interested in your enterprise plan.โ€
โ†’ AI shows a Contact Form to collect Name, Email, and Company.
โ†’ Data is sent to CRM or Slack via webhook.


2. ๐Ÿ› Product Purchase or Quote Request โ€‹

If a visitor shows interest in buying a product, you can request form details before processing the order.
Example:
User says: โ€œI want to buy this course.โ€
โ†’ AI shows Purchase Form with fields for Name, Email, and Payment Preference.
โ†’ On submit, Ainisa calls your webhook (e.g., via n8n) to create an order.


3. ๐ŸŽŸ Promo Campaign or Coupon Form โ€‹

You can use a form + CTA combo to give visitors special offers.
Example:
User says: โ€œDo you have any promo?โ€
โ†’ AI shows a Promo Form with Name and Email fields.
โ†’ After submission, it shows CTA with code: AINISA2025.


4. ๐Ÿ’ฌ Feedback or Survey Collection โ€‹

After finishing a chat session or support interaction, AI can show a short Feedback Form.
Example fields: rating (1โ€“5), feedback message, and email.
โ†’ Submissions go to Google Sheets or Notion via webhook.


5. ๐Ÿง‘โ€๐Ÿ’ป Service Request Form โ€‹

For service-based businesses (marketing agencies, web developers, etc.), the form can be used to start new project requests.
Example fields: Name, Email, Project Type, and Budget.
โ†’ Webhook sends data to project management tools (e.g., ClickUp, Trello, or Monday).


โœ… Summary โ€‹

The Custom Form action allows you to turn your AI assistant into an interactive lead capture or data collection tool โ€” connected to your backend through webhooks or automation workflows.

Perfect for:

  • Contact or callback forms
  • Booking or quote requests
  • Surveys or feedback forms
  • Coupon or promo campaigns
  • Product purchase forms