# Moveo

> Work with your Moveo.AI conversational AI: chat with and classify text through your AI agents, manage contacts, search knowledge bases, and read campaigns and conversations.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/moveo

## Actions

### Classify text

Find the intents and entities an AI agent recognises in messages, one message per line. The agent must be trained.

**Inputs**

- AI agent (`brain_id`, text, required): The AI agent. Pick one, or give its id from an earlier step.
- Messages (`texts`, text, required): The messages to classify, one per line (up to 1000).

**Outputs**

- `count` (number): How many messages
- `results` (list): One result per message: processed_text, intents, entities and entropies

**Example output**

```json
{
  "count": 1,
  "results": [
    {
      "entities": [],
      "entropies": [
        0.1
      ],
      "intents": [
        {
          "confidence": 0.95,
          "intent": "order_status"
        }
      ],
      "processed_text": "where is my order"
    }
  ]
}
```

### Create contact

Add a contact. Give a name and at least an email or a phone number. A later message from that email or number reaches this contact instead of making a duplicate.

**Inputs**

- Name (`name`, text, required): The contact's name.
- Email (`email`, text): The contact's email address. Stored in lowercase.
- Phone (`phone`, text): The contact's phone number with its country code, like +15555555555. Moveo stores it in that format.
- Time zone (`time_zone`, text): The contact's time zone, such as America/New_York.
- Language (`language`, text): The contact's language code, such as en.
- Role (`role`, text): The contact's role or job title.
- External ID (`external_id`, text): An id for this contact from your own system.
- Custom fields (`custom_fields`, object): Extra details as names and values (text, numbers or true/false). Each name must already be defined as a custom field in Moveo.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "contact_id": "c0ffee00-1234-4abc-8def-0123456789ab",
    "created": "2026-10-01T09:00:00Z",
    "custom_fields": {
      "plan": "pro"
    },
    "deceased": false,
    "email": "ada@example.com",
    "external_id": "crm-1001",
    "language": "en",
    "last_contacted": "2026-10-19T09:00:00Z",
    "last_replied": "2026-10-20T09:05:00Z",
    "last_seen": "2026-10-20T09:00:00Z",
    "name": "Ada Lovelace",
    "phone": "+15555550100",
    "role": "Engineer",
    "source": "manual",
    "time_zone": "Europe/London",
    "updated": "2026-10-01T09:00:00Z"
  }
}
```

### Delete contact

Delete a contact. This cannot be undone.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or 'Create contact'.

**Outputs**

- `contact_id` (text): The contact deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "contact_id": "c0ffee00-1234-4abc-8def-0123456789ab",
  "deleted": true
}
```

### Get AI agent

Get one AI agent: its language, description and status.

**Inputs**

- AI agent (`brain_id`, text, required): The AI agent. Pick one, or give its id from an earlier step.

**Outputs**

- `brain` (object): The AI agent

**Example output**

```json
{
  "brain": {
    "brain_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "confidence_threshold": 0.7,
    "created": "2026-09-01T09:00:00Z",
    "description": "Answers customer questions",
    "inactivity_timeout": 900,
    "language": "en",
    "name": "Support agent",
    "status": "ready",
    "updated": "2026-10-01T09:00:00Z"
  }
}
```

### Get campaign

Get one campaign: its type, status and dates.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign` (object): The campaign

**Example output**

```json
{
  "campaign": {
    "campaign_id": "ca11ba11-0000-4000-8000-00000000c0de",
    "created": "2026-10-01T09:00:00Z",
    "name": "Renewal reminder",
    "started": "2026-10-10T09:00:00Z",
    "status": "sent",
    "type": "utility",
    "updated": "2026-10-10T09:00:00Z"
  }
}
```

### Get contact

Get one contact with their details and custom fields.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or 'Create contact'.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "contact_id": "c0ffee00-1234-4abc-8def-0123456789ab",
    "created": "2026-10-01T09:00:00Z",
    "custom_fields": {
      "plan": "pro"
    },
    "deceased": false,
    "email": "ada@example.com",
    "external_id": "crm-1001",
    "language": "en",
    "last_contacted": "2026-10-19T09:00:00Z",
    "last_replied": "2026-10-20T09:05:00Z",
    "last_seen": "2026-10-20T09:00:00Z",
    "name": "Ada Lovelace",
    "phone": "+15555550100",
    "role": "Engineer",
    "source": "manual",
    "time_zone": "Europe/London",
    "updated": "2026-10-01T09:00:00Z"
  }
}
```

### List AI agents

List your AI agents with their language and status. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only those whose name matches this text.
- Page size (`limit`, number): How many to return, 1 to 100. Moveo's default is 50. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `brains` (list): The AI agents
- `count` (number): How many on this page
- `has_more` (true/false): True when there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "brains": [
    {
      "brain_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "confidence_threshold": 0.7,
      "created": "2026-09-01T09:00:00Z",
      "description": "Answers customer questions",
      "inactivity_timeout": 900,
      "language": "en",
      "name": "Support agent",
      "status": "ready",
      "updated": "2026-10-01T09:00:00Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### List campaigns

List campaigns, filtered by type, status or name. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Type (`campaign_type`, text): Only campaigns of this type. One of: `marketing`, `sales`, `utility`, `payment_recovery` (Payment recovery).
- Status (`status`, text): Only campaigns in this state. One of: `draft`, `ready`, `in_progress` (In progress), `sent`, `canceled`, `failed`.
- Name contains (`name`, text): Only those whose name matches this text.
- Page size (`limit`, number): How many to return, 1 to 100. Moveo's default is 50. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `campaigns` (list): The campaigns
- `count` (number): How many on this page
- `has_more` (true/false): True when there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "campaigns": [
    {
      "campaign_id": "ca11ba11-0000-4000-8000-00000000c0de",
      "created": "2026-10-01T09:00:00Z",
      "name": "Renewal reminder",
      "started": "2026-10-10T09:00:00Z",
      "status": "sent",
      "type": "utility",
      "updated": "2026-10-10T09:00:00Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### List contacts

List contacts, or search them by name, email or phone. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`q`, text): Find contacts by name, email or phone. At least three letters or digits.
- How the contact was added (`source`, text): Only contacts added this way. One of: `inbound` (Inbound (started a conversation)), `outbound` (Outbound (was messaged)), `manual` (Manual (added by hand or API)).
- Page size (`limit`, number): How many to return, 1 to 100. Moveo's default is 50. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many on this page
- `has_more` (true/false): True when there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "contacts": [
    {
      "contact_id": "c0ffee00-1234-4abc-8def-0123456789ab",
      "created": "2026-10-01T09:00:00Z",
      "custom_fields": {
        "plan": "pro"
      },
      "deceased": false,
      "email": "ada@example.com",
      "external_id": "crm-1001",
      "language": "en",
      "last_contacted": "2026-10-19T09:00:00Z",
      "last_replied": "2026-10-20T09:05:00Z",
      "last_seen": "2026-10-20T09:00:00Z",
      "name": "Ada Lovelace",
      "phone": "+15555550100",
      "role": "Engineer",
      "source": "manual",
      "time_zone": "Europe/London",
      "updated": "2026-10-01T09:00:00Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### List conversations

List the conversations in an environment, filtered by status or AI agent. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Environment (`desk_id`, text, required): The environment the conversations are stored in. Pick one, or give its id.
- Status (`status`, text): Only conversations in this state. One of: `open`, `closed`, `trash`, `spam`.
- AI agent (`brain_id`, text): Only conversations handled by this AI agent.
- Page size (`limit`, number): How many to return, 1 to 100. Moveo's default is 50. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `conversations` (list): The conversations
- `count` (number): How many on this page
- `has_more` (true/false): True when there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "conversations": [
    {
      "created": "2026-10-20T09:00:00Z",
      "message_count": 4,
      "session_id": "5e55a0a0-1111-4222-8333-444455556666",
      "status": "open",
      "updated": "2026-10-20T09:05:00Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### List environments

List the environments (workspaces) where conversations are stored. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only those whose name matches this text.
- Page size (`limit`, number): How many to return, 1 to 100. Moveo's default is 50. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `desks` (list): The environments
- `has_more` (true/false): True when there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "desks": [
    {
      "account_id": "7e6d5c4b-3a29-4f18-a0b1-c2d3e4f5a6b7",
      "created": "2026-09-01T09:00:00Z",
      "desk_id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
      "name": "Production",
      "updated": "2026-10-01T09:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": ""
}
```

### List knowledge bases

List the knowledge bases your AI agents answer from. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. Moveo's default is 50. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `collections` (list): The knowledge bases
- `count` (number): How many on this page
- `has_more` (true/false): True when there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "collections": [
    {
      "collection_id": "d4c3b2a1-f0e9-4d8c-b7a6-5f4e3d2c1b0a",
      "created": "2026-09-01T09:00:00Z",
      "fragment_count": 42,
      "language": "en",
      "name": "Help centre",
      "updated": "2026-10-01T09:00:00Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### Search knowledge base

Search a knowledge base and get the best matching documents, ranked. Searches by meaning unless you choose exact words.

**Inputs**

- Knowledge base (`collection_id`, text, required): The knowledge base. Pick one, or give its id from an earlier step.
- Search for (`query`, text, required): What to look for, in plain words.
- Search by (`mode`, text): Meaning finds related text; exact words need a match. One of: `semantic` (By meaning (default)), `keyword` (By exact words).
- Most documents (`limit`, number): How many documents to return, 1 to 20. Moveo's default is 5. From 1 to 20.

**Outputs**

- `count` (number): How many matched
- `documents` (list): The matching documents, best first

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "content": "...",
      "score": 0.82,
      "title": "Refund policy"
    }
  ]
}
```

### Send message to AI agent

Send a message to an AI agent and get its reply. Starts a new test conversation unless you give a Conversation ID from an earlier message. Moveo bills each message.

**Inputs**

- AI agent (`brain_id`, text, required): The AI agent. Pick one, or give its id from an earlier step.
- Message (`text`, text, required): What to say to the AI agent.
- Conversation ID (`session_id`, text): To carry on a conversation, the 'session_id' an earlier message returned. Leave empty to start a new one.
- Your name (`user_name`, text): The name the AI agent sees. Defaults to Lodol.

**Outputs**

- `entities` (list): The entities Moveo found in the message
- `intents` (list): The intents Moveo found in the message
- `replies` (list): Each piece of text the AI agent said
- `reply` (text): Everything the AI agent said, one line each
- `responses` (list): Moveo's full reply actions (buttons, cards and so on)
- `session_id` (text): The conversation's id; pass it to the next message

**Example output**

```json
{
  "entities": [],
  "intents": [
    {
      "confidence": 0.98,
      "intent": "greeting"
    }
  ],
  "replies": [
    "Hello! How can I help?"
  ],
  "reply": "Hello! How can I help?",
  "responses": [
    {
      "text": "Hello! How can I help?",
      "type": "text"
    }
  ],
  "session_id": "5e55a0a0-1111-4222-8333-444455556666"
}
```

### Update contact

Change fields on a contact. Only the fields you fill in change; empty ones are left as they are.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or 'Create contact'.
- Name (`name`, text): A new name for the contact.
- Email (`email`, text): The contact's email address. Stored in lowercase.
- Phone (`phone`, text): The contact's phone number with its country code, like +15555555555. Moveo stores it in that format.
- Time zone (`time_zone`, text): The contact's time zone, such as America/New_York.
- Language (`language`, text): The contact's language code, such as en.
- Role (`role`, text): The contact's role or job title.
- External ID (`external_id`, text): An id for this contact from your own system.
- Custom fields (`custom_fields`, object): Extra details as names and values (text, numbers or true/false). Each name must already be defined as a custom field in Moveo.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "contact_id": "c0ffee00-1234-4abc-8def-0123456789ab",
    "created": "2026-10-01T09:00:00Z",
    "custom_fields": {
      "plan": "pro"
    },
    "deceased": false,
    "email": "ada@example.com",
    "external_id": "crm-1001",
    "language": "en",
    "last_contacted": "2026-10-19T09:00:00Z",
    "last_replied": "2026-10-20T09:05:00Z",
    "last_seen": "2026-10-20T09:00:00Z",
    "name": "Ada Lovelace",
    "phone": "+15555550100",
    "role": "Engineer",
    "source": "manual",
    "time_zone": "Europe/London",
    "updated": "2026-10-01T09:00:00Z"
  }
}
```
