Update Conversation | AgentPhone

import { AgentPhoneClient } from "agentphone";
async function main() {
    const client = new AgentPhoneClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.conversations.updateConversation("conversation_id", {});
}
main();

{
  "id": "string",
  "phoneNumberId": "string",
  "phoneNumber": "string",
  "participant": "string",
  "lastMessageAt": "2024-01-15T09:30:00Z",
  "messageCount": 1,
  "createdAt": "2024-01-15T09:30:00Z",
  "messages": [
    {
      "id": "string",
      "body": "string",
      "fromNumber": "string",
      "toNumber": "string",
      "direction": "string",
      "receivedAt": "2024-01-15T09:30:00Z",
      "channel": "string",
      "mediaUrl": "string",
      "reactions": [
        {
          "id": "string",
          "reactionType": "string",
          "fromNumber": "string",
          "direction": "string",
          "createdAt": "2024-01-15T09:30:00Z"
        }
      ]
    }
  ],
  "agentId": "string",
  "metadata": {}
}

Update conversation metadata (state).

Use this to store custom context for AI agents:

Customer information (name, account ID)
Business context (order ID, ticket number)
Session state (current topic, preferences)

The metadata is included in webhook payloads as conversationState.

Update conversation metadata (state). Use this to store custom context for AI agents: - Customer information (name, account ID) - Business context (order ID, ticket number) - Session state (current topic, preferences) The metadata is included in webhook payloads as `conversationState`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

conversation_idstringRequired

Request

This endpoint expects an object.

metadataobject or nullOptional

Response

Successful Response

idstring

phoneNumberIdstring

phoneNumberstring

participantstring

lastMessageAtdatetime

messageCountinteger

createdAtdatetime

messageslist of objects

agentIdstring or null

metadataobject or null

Errors

422

Unprocessable Entity Error