Error Handling

Operational failures (success=false, timeouts) return a CommandResult or SendMessageResult - inspect the return value. Exceptions cover connection loss, invalid state, and authentication or session errors. Most call commands do not raise when answer() or connect() fails; they return a falsy CommandResult (if not result: works). WhatsApp send failures stay on SendMessageResult; check result.success (do not use if result:). Unsupported message types raise MessageError.

Exception hierarchy (selected)

Catch AgentDuetError for any SDK error, or a subclass for finer control.

Unanswered connect() / dial()

result = await call.connect(ring_time_seconds=30)
if not result:
    if result.error_code == "CALL_UNANSWERED":
        await call.disconnect()
    else:
        logger.error(
            "Connect failed: %s (%s)", result.error_message, result.error_code
        )

The call can stay active after CALL_UNANSWERED - retry, try another number, or end it.

WhatsApp send failures

result = await session.send_message(msg)
if not result.success:
    logger.error(
        "Send failed: %s (%s)", result.error_code, result.error_content
    )

See WhatsApp Messaging.

Audio loops

try:
    async for chunk in call.caller.audio_stream():
        await call.send_audio(chunk)
except CallClosedError:
    pass  # normal end

Next Step