---
title: "pre-conversation"
method: POST
path: "/webhook-events/pre-conversation"
tags: ["Webhooks"]
---

# pre-conversation

`POST /webhook-events/pre-conversation`

Fired **before** the agent begins speaking. Use this to enrich CRM
data, log call attempts, or gate outbound calls.

Does **not** contain `callData`, `transcript`, `variables`, `analytics`,
or `recordingUrl`. `callData` is on `post-conversation` and
`analytics-completed`; `transcript`, `variables`, and `recordingUrl`
are only on `post-conversation`; `analytics` is only on
`analytics-completed`.

**Delivery.** Sent as an HTTP POST with a 30 second timeout. Non-2xx
responses and network errors mark the delivery as failed; there are
no retries. Verify the `X-Signature` header before trusting the body.
For the full field-level reference, see the [Webhooks guide](/atoms/atoms-platform/features/webhooks).

## Headers

- `X-Signature` string, required

## Request body

- WebhookEventPreConversation — Common envelope shared by every webhook event Atoms delivers to your endpoint. The `metadata` field's shape varies by event type — see the per-event schemas (`WebhookEventPreConversation`, `WebhookEventPostConversation`, `WebhookEventAnalyticsCompleted`).
  - `url` string, required — The webhook URL endpoint that received the event.
  - `description` string, required — Human-readable label configured on the webhook (e.g. "Debt Collection Agent's Endpoint").
  - `event` string, required — Event identifier in the form `{agentId}.{eventType}`.
  - `id` string, required — Unique webhook delivery ID (separate from `metadata.callId`).
  - `metadata` object, required
    - `agentId` string, required — The Atoms agent ID that handled the call.
    - `eventType` 'pre-conversation', required
    - `conversationType` string, required — Channel type. Known values: `telephonyOutbound`, `telephonyInbound`.
    - `toPhone` string, required — Destination phone number in E.164 format.
    - `fromPhone` string, required — Originating phone number in E.164 format.
    - `callId` string, required — Unique call identifier.

## Response `2XX`

Your endpoint should return a 2XX status to acknowledge receipt.

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)