Livkeit SIP Service Testing: Outbound/Inbound Call Events & Statuses

[vlxdisluv]

Description
I'm looking for an easy way to connect to a room as a participant for testing purposes in livekit-sip service. The goal is to simulate and verify various SIP events (including error cases) during both outbound and inbound calls.

Background
When I deployed my code to the development stage, I encountered an unhandled scenario where the customer was busy. It would be nice to have a way to simulate this locally and handle it appropriately. The logs below illustrate the unhandled event:

2025-04-14T09:57:59.997Z	INFO	sip	sip/outbound.go:755	auth requested	{"nodeID": "NE_Mr3Xs7TrcUaC", "callID": "SCL_ec3vjkVrWWPq", "room": "outbound-campaign-call:company-id:7bdb1572-2d5d-49a4-9835-3cfea4988ddd:campaign-id:081a67b6-6325-4f86-80c3-e69906d73479:conversation-id:a47ee872-fa3b-4300-86d2-285de2b508bf", "participant": "callee", "participantName": "", "fromHost": "", "fromUser": "+3**", "toHost": "twilio.com", "toUser": "+9***", "sipCallID": "v7YfsH0seGSh3DfieXSlv7X5RALB", "status": 407, "body": ""}
2025-04-14T09:58:01.744Z	INFO	sip	sip/outbound.go:518	SIP invite failed	{"nodeID": "NE_Mr3Xs7TrcUaC", "callID": "SCL_ec3vjkVrWWPq", "room": "outbound-campaign-call:company-id:7bdb1572-2d5d-49a4-9835-3cfea4988ddd:campaign-id:081a67b6-6325-4f86-80c3-e69906d73479:conversation-id:a47ee872-fa3b-4300-86d2-285de2b508bf", "participant": "callee", "participantName": "", "fromHost": "", "fromUser": "+3**", "toHost": "twilio.com", "toUser": "+9***", "error": "INVITE failed: sip status: 486 (BUSY_HERE)"}
2025-04-14T09:58:01.744Z	INFO	sip	sip/outbound.go:294	SIP call failed	{"nodeID": "NE_Mr3Xs7TrcUaC", "callID": "SCL_ec3vjkVrWWPq", "room": "outbound-campaign-call:company-id:7bdb1572-2d5d-49a4-9835-3cfea4988ddd:campaign-id:081a67b6-6325-4f86-80c3-e69906d73479:conversation-id:a47ee872-fa3b-4300-86d2-285de2b508bf", "participant": "callee", "participantName": "", "fromHost": "", "fromUser": "+3**", "toHost": "twilio.com", "toUser": "+9***", "error": "INVITE failed: sip status: 486 (BUSY_HERE)"}
2025-04-14T09:58:01.744Z	INFO	sip	sip/outbound.go:254	Closing outbound call	{"nodeID": "NE_Mr3Xs7TrcUaC", "callID": "SCL_ec3vjkVrWWPq", "room": "outbound-campaign-call:company-id:7bdb1572-2d5d-49a4-9835-3cfea4988ddd:campaign-id:081a67b6-6325-4f86-80c3-e69906d73479:conversation-id:a47ee872-fa3b-4300-86d2-285de2b508bf", "participant": "callee", "participantName": "", "fromHost": "", "fromUser": "+3***", "toHost": "twilio.com", "toUser": "+9***", "reason": "busy"}

Request

• Are there any recommendations, built-in tools, or best practices in the project for simulating SIP events during local testing?

Any advice or guidance on this topic would be highly appreciated.

Thank you!

[biglittlebigben]

https://github.com/livekit/sip/tree/main/test/client has a utility that can be used to script SIP calls locally and should allow you to test event handling.