Conversations
A conversation is the thread between a cell and a contact (or between two numbers). conversationState tells your agent whether to wait, reply, or start a new thread.
Organization
Parent
Cell
Parent
Conversation
This guide
List and between
List conversations for a cell, fetch a thread, or look up the pair of numbers with GET /conversations/between.
const thread = await agentcell.conversations.between({
a: "+14155550192",
b: "+14155550144",
});conversationState
Use state to decide the next action: active, awaiting_reply, closed, or limited by streak rules.
| State | Agent action |
|---|---|
| active | Continue the thread. |
| awaiting_reply | Do not start a new outbound until the contact replies. |
| streak_limited | CONVERSATION_STREAK_LIMIT — wait for inbound. |
Common errors
- CONVERSATION_STREAK_LIMIT
The contact must reply before more outbound.
Copy for Cursor / Claude
List conversations for a cell, then fetch the thread with a contact.
agentcell cells conversations list --cell-id $CELL_ID
agentcell cells conversations with --cell-id $CELL_ID --contact +14155550144