Setup
Use a key dedicated to the phone system.
- 01
Create a calls:create key
Name the key after the PBX and keep it on the server that publishes call events.
- 02
Read PBX configuration
Call GET /public/pbx-config to confirm the tenant and canonical webhook URL.
- 03
Map lifecycle events
Send started or ringing, answered when available, and one completed or missed event.
- 04
Keep asteriskId stable
Every event for the same call must use the same identifier.
- 05
Verify customer association
Use normalized external numbers and confirm the call appears on the expected timeline.
Minimum payload
Include the participants, direction, and timing.
Completed call event
curl --request POST \
--url https://api.crm.peopletide.com/api/v1/crm/calls/webhook/asterisk \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"event": "call.completed",
"timestamp": "2026-09-13T10:05:00Z",
"asteriskId": "1757757600.42",
"from": { "number": "+919876543210" },
"to": { "number": "+914044440000", "extension": "201" },
"direction": "inbound",
"startTime": "2026-09-13T10:00:00Z",
"answerTime": "2026-09-13T10:00:12Z",
"endTime": "2026-09-13T10:05:00Z",
"disposition": "ANSWERED"
}'