---
title: "Suggest three short texts a manager could send the rep at this visit"
description: "Owners, admins and managers. Built from the visit's step progress and timing only (skipped step, current step, steps covered, minutes on site), never from the conversation. Uses the workspace's own AI key."
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.channelautomations.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Channel Automation API › Conversations

`POST /api/field-sales/visits/{appointmentId}/message/suggest`

Owners, admins and managers. Built from the visit's step progress and timing only (skipped step, current step, steps covered, minutes on site), never from the conversation. Uses the workspace's own AI key.

## Authentication

- `BearerAuth`, http, header `Authorization`, format `JWT`

## Path parameters

- `appointmentId` (`post/api/field-sales/visits/appointmentId/message/suggest.path.appointmentId`; string, required)
  - format `uuid`

## Code samples

### cURL

```bash
curl --request POST \
  --url 'https://api.channelautomation.com/api/field-sales/visits/<appointmentId>/message/suggest' \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.channelautomation.com/api/field-sales/visits/<appointmentId>/message/suggest';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.channelautomation.com/api/field-sales/visits/<appointmentId>/message/suggest"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)
```

## Responses

### 200

{ success, suggestions: string[] }

### 404

The visit has no assigned rep

### 409

No workspace AI key


Source: https://developer.channelautomations.com/api/post-api-field-sales-visits-appointment-id-message-suggest/index.md