Developers

Build with BizzBuzz API

Extensive documentation, guides, and API references to help you build powerful conversational experiences.

Conversations

Conversations represent a thread of messages between your business and a customer. You can list, retrieve, and manage conversations through the API.

List all conversations

GET /conversations

Returns a list of conversations for the authenticated business Account.

// Response
{
  "data": [
    {
      "id": "conv_123456789",
      "status": "open",
      "contact": {
        "id": "cnt_987654321",
        "name": "Jane Doe"
      },
      "last_message_at": "2024-03-20T14:30:00Z",
      "created_at": "2024-03-20T10:00:00Z"
    }
  ],
  "has_more": true
}

Retrieve a conversation

GET /conversations/:id

Retrieves the details of an existing conversation.

// Response
{
  "id": "conv_123456789",
  "status": "open",
  "channel": "whatsapp",
  "contact": {
    "id": "cnt_987654321",
    "name": "Jane Doe",
    "phone": "+1234567890"
  },
  "metadata": {},
  "created_at": "2024-03-20T10:00:00Z"
}

Update a conversation

PATCH /conversations/:id

Updates the specified conversation, such as changing its status or assigning an agent.

// Request
{
  "status": "closed",
  "metadata": {
    "resolved_reason": "customer_satisfied"
  }
}
Ready to scale?

Scale your
impact.

Enterprise Ready
Direct Meta Sync
99.99% Uptime SLA

Join the elite circle of founders who have automated their scaling logic.

Secure your Competitive Advantage today.

No credit card required · Setup in under 5 minutes