Webhooks & Automation

Webhooks allow you to connect Texterz to your existing tech stack (Zapier, Make, n8n, or custom backends) by sending real-time data when specific events occur.

Event Types

Event	Trigger
lead.qualified	The agent has gathered all required lead data.
meeting.booked	A user has successfully booked a meeting via Calendly/Google Calendar.
message.received	A new message has arrived from a customer.
human.requested	The user explicitly asked for a human or the AI triggered an escalation.

Payload Structure (JSON)

Every webhook sent by Texterz follows a standard format:

{
  "event": "lead.qualified",
  "timestamp": "2024-05-20T14:30:00Z",
  "data": {
    "orgId": "org_123",
    "botId": "bot_456",
    "contact": {
      "id": "user_789",
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "+1234567890"
    },
    "conversation": {
      "id": "conv_abc",
      "summary": "User is interested in solar panels for a 3-bedroom house.",
      "transcript_url": "https://app.texterz.ai/conversations/conv_abc"
    },
    "custom_fields": {
      "budget": "5000",
      "timeline": "next 3 months"
    }
  }
}

Security

To ensure that webhooks are actually coming from Texterz, we recommend checking the X-Texterz-Signature header.

• We sign the payload using your Webhook Secret.
• You can verify the HMAC SHA-256 signature on your server.

---

Implementation

Learn how to connect these to outcomes in 4. Tools.