Консоль
Integrations

TwentyCRM

Configure a TwentyCRM workspace and field mapping for agent leads

Status: Available in the Integrations catalog.

TwentyCRM is connected at the team level. The integration stores the workspace URL, API key, target object, stage field, stage value, and the field mapping AIVA may use.

What you need

  • Workspace URL
  • a bearer API key
  • the target object name, for example clientFunnels
  • the stage field name, for example stage
  • the stage value, for example NEW_LEAD

Add the integration

  1. In Twenty, open Settings -> API & Webhooks and create an API key.
  2. In AIVA Console, open Integrations -> TwentyCRM -> Add.
  3. Fill in Title, Workspace URL, API key, Target object, Stage field, and Stage value.
  4. Save the record.

After saving

  • Open the detail page and click Refresh fields so AIVA can re-read the target object schema.
  • Enable only the Twenty fields that the agent should fill.
  • For enabled fields, add instructions whenever the LLM must transform the call into a specific output format.
  • Use Test integration after changing the workspace URL, API key, or object schema.

Assign it to an agent

  1. Open the agent.
  2. In its integrations section, choose the prepared TwentyCRM record.
  3. Save the agent.

Field mapping stays inside the integration detail page. The agent editor only selects which prepared integration to use.

Safe example

Title: Main sales funnel
Workspace URL: https://crm.example.com
API key: twenty-demo-key
Target object: clientFunnels
Stage field: stage
Stage value: NEW_LEAD

If records do not reach Twenty

  • confirm the API key is still valid
  • make sure the object name and stage field match the real workspace schema
  • refresh the field catalog after schema changes inside Twenty