Conversations

curl https://api.recoverbiz.com/v1/accounts/acc_8f3a1b2c/conversations?limit=20 \
  -H "X-Partner-Key: pk_live_abc123def456..."

{
  "conversations": [
    {
      "phone": "+14155551234",
      "name": "John Doe",
      "preview": "Sure, I can send the T4 slip tomorrow morning.",
      "last_message_at": "2026-02-14T15:30:00Z",
      "message_count": 12,
      "needs_handoff": false,
      "lead_status": "qualified",
      "in_sequence": true
    }
  ],
  "total": 289,
  "limit": 20,
  "offset": 0
}

curl https://api.recoverbiz.com/v1/accounts/acc_8f3a1b2c/conversations/+14155551234/messages?limit=50 \
  -H "X-Partner-Key: pk_live_abc123def456..."

{
  "messages": [
    {
      "id": "msg_001",
      "direction": "outbound",
      "body": "Hi John, this is Acme Lending. We noticed your loan application is almost complete — just a few documents left. Can I help?",
      "sent_at": "2026-02-10T10:00:00Z",
      "source": "sequence"
    },
    {
      "id": "msg_002",
      "direction": "inbound",
      "body": "Hey, yeah I still need to send my bank statements. What exactly do you need?",
      "sent_at": "2026-02-10T10:05:00Z"
    },
    {
      "id": "msg_003",
      "direction": "outbound",
      "body": "No problem! We need your last 3 months of bank statements. You can just snap a photo and text it to me here, or send a PDF if you have one.",
      "sent_at": "2026-02-10T10:05:30Z",
      "source": "ai"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

curl -X POST https://api.recoverbiz.com/v1/accounts/acc_8f3a1b2c/conversations/+14155551234/messages \
  -H "X-Partner-Key: pk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Hi John, this is Sarah from Acme Lending. I wanted to follow up personally — let me know if you have any questions about the application.",
    "sender_name": "Sarah Johnson"
  }'

{
  "success": true,
  "message_id": "msg_042",
  "direction": "outbound",
  "source": "manual"
}

curl -X POST https://api.recoverbiz.com/v1/accounts/acc_8f3a1b2c/conversations/+14155551234/resume-ai \
  -H "X-Partner-Key: pk_live_abc123def456..."

{
  "success": true,
  "ai_enabled": true
}