Recaudo Docs
Sign up

Conversations

Assign conversation

Assign conversations to human agents on your team

Assign agent

POST /v1/conversations/{'{id}'}/assign

Assigns a conversation to a member of your team. When assigned, the conversation is handled by a person and the artificial intelligence agent stops answering.

Field Type Required Description
user_iduuidNoUUID of the team member. Use GET /v1/team to get the available IDs
Request example 
curl -X POST https://recaudo.app/api/v1/conversations/{id}/assign \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "uuid-del-agente" }'
Response 
{
  "object": "conversation",
  "data": {
    "id": "uuid-de-la-conversacion",
    "channel": "whatsapp",
    "status": "open",
    "is_handled_by_ai": false,
    "assigned_user": {
      "id": "uuid-del-agente",
      "name": "María López"
    },
    "customer": {
      "id": "uuid-del-cliente",
      "name": "Juan Pérez",
      "phone": "+5215512345678"
    },
    "updated_at": "2026-04-08T10:30:00Z"
  }
}
Was this page helpful? Thanks for letting us know.
Esc