Call Transfer

1
from signalwire import AgentBase
2
from signalwire.core.function_result import FunctionResult
3
4
class TransferAgent(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="transfer-agent")
7
        self.add_language("English", "en-US", "rime.spore")
8
9
        self.prompt_add_section(
10
            "Role",
11
            "You are a receptionist who can transfer calls to different departments."
12
        )
13
14
        self.define_tool(
15
            name="transfer_to_sales",
16
            description="Transfer the caller to the sales department",
17
            parameters={"type": "object", "properties": {}},
18
            handler=self.transfer_to_sales
19
        )
20
21
    def transfer_to_sales(self, args, raw_data):
22
        return (
23
            FunctionResult("Transferring you to sales now.")
24
            .connect("+15551234567", final=True)
25
        )
26
27
if __name__ == "__main__":
28
    agent = TransferAgent()
29
    agent.run()

1
from signalwire import AgentBase
2
from signalwire.core.function_result import FunctionResult
3
4
class SmartTransferAgent(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="smart-transfer-agent")
7
        self.add_language("English", "en-US", "rime.spore")
8
9
        self.prompt_add_section(
10
            "Role",
11
            "You can transfer calls permanently or temporarily."
12
        )
13
14
        self._register_functions()
15
16
    def _register_functions(self):
17
        self.define_tool(
18
            name="transfer_permanent",
19
            description="Permanently transfer to support (call ends with agent)",
20
            parameters={
21
                "type": "object",
22
                "properties": {
23
                    "number": {"type": "string", "description": "Phone number"}
24
                },
25
                "required": ["number"]
26
            },
27
            handler=self.transfer_permanent
28
        )
29
30
        self.define_tool(
31
            name="transfer_temporary",
32
            description="Temporarily connect to expert, then return to agent",
33
            parameters={
34
                "type": "object",
35
                "properties": {
36
                    "number": {"type": "string", "description": "Phone number"}
37
                },
38
                "required": ["number"]
39
            },
40
            handler=self.transfer_temporary
41
        )
42
43
    def transfer_permanent(self, args, raw_data):
44
        number = args.get("number")
45
        return (
46
            FunctionResult(f"Transferring you now. Goodbye!")
47
            .connect(number, final=True)
48
        )
49
50
    def transfer_temporary(self, args, raw_data):
51
        number = args.get("number")
52
        return (
53
            FunctionResult("Connecting you briefly. I'll be here when you're done.")
54
            .connect(number, final=False)
55
        )
56
57
if __name__ == "__main__":
58
    agent = SmartTransferAgent()
59
    agent.run()

1
def transfer_to_sip(self, args, raw_data):
2
    return (
3
        FunctionResult("Connecting to internal support")
4
        .connect("sip:support@company.com", final=True)
5
    )

1
def transfer_with_custom_callerid(self, args, raw_data):
2
    return (
3
        FunctionResult("Connecting you now")
4
        .connect(
5
            "+15551234567",
6
            final=True,
7
            from_addr="+15559876543"  # Custom caller ID
8
        )
9
    )

1
from signalwire import AgentBase
2
from signalwire.core.function_result import FunctionResult
3
4
class MultiAgentTransfer(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="multi-agent-transfer")
7
        self.add_language("English", "en-US", "rime.spore")
8
9
        self.prompt_add_section("Role", "You route calls to specialized agents.")
10
11
        self.define_tool(
12
            name="transfer_to_billing",
13
            description="Transfer to the billing specialist agent",
14
            parameters={"type": "object", "properties": {}},
15
            handler=self.transfer_to_billing
16
        )
17
18
    def transfer_to_billing(self, args, raw_data):
19
        return (
20
            FunctionResult(
21
                "I'm transferring you to our billing specialist.",
22
                post_process=True  # Speak message before transfer
23
            )
24
            .swml_transfer(
25
                dest="https://agents.example.com/billing",
26
                ai_response="How else can I help?",  # Used if final=False
27
                final=True
28
            )
29
        )
30
31
if __name__ == "__main__":
32
    agent = MultiAgentTransfer()
33
    agent.run()

1
def transfer_with_sms(self, args, raw_data):
2
    caller_number = raw_data.get("caller_id_number")
3
4
    return (
5
        FunctionResult("I'm transferring you and sending a confirmation text.")
6
        .send_sms(
7
            to_number=caller_number,
8
            from_number="+15559876543",
9
            body="You're being transferred to our support team. Reference #12345"
10
        )
11
        .connect("+15551234567", final=True)
12
    )

1
def announced_transfer(self, args, raw_data):
2
    return (
3
        FunctionResult(
4
            "Please hold while I transfer you to our specialist. "
5
            "This should only take a moment.",
6
            post_process=True  # AI speaks this before transfer executes
7
        )
8
        .connect("+15551234567", final=True)
9
    )

1
def cold_transfer(self, args, raw_data):
2
    return (
3
        FunctionResult("Transferring you to support now.")
4
        .connect("+15551234567", final=True)
5
    )

1
def warm_transfer_with_context(self, args, raw_data):
2
    caller_number = raw_data.get("caller_id_number")
3
    call_summary = "Caller needs help with billing dispute"
4
5
    return (
6
        FunctionResult(
7
            "I'm transferring you to our billing specialist. "
8
            "I'll let them know about your situation.",
9
            post_process=True
10
        )
11
        .send_sms(
12
            to_number="+15551234567",
13
            from_number="+15559876543",
14
            body=f"Incoming transfer: {caller_number}\n{call_summary}"
15
        )
16
        .connect("+15551234567", final=True)
17
    )

1
def transfer_to_department(self, args, raw_data):
2
    dept = args.get("department", "").lower()
3
4
    DEPARTMENTS = {
5
        "sales": "+15551111111",
6
        "support": "+15552222222",
7
    }
8
9
    if dept not in DEPARTMENTS:
10
        return FunctionResult(
11
            f"I don't have a number for '{dept}'. "
12
            "I can transfer you to Sales or Support."
13
        )
14
15
    return (
16
        FunctionResult(f"Transferring to {dept}.")
17
        .connect(DEPARTMENTS[dept], final=True)
18
    )

1
def consultation_transfer(self, args, raw_data):
2
    return (
3
        FunctionResult(
4
            "Let me connect you with a specialist briefly."
5
        )
6
        .connect(
7
            "+15551234567",
8
            final=False  # Call returns to agent if transfer fails or ends
9
        )
10
    )

1
def escalate_to_human(self, args, raw_data):
2
    reason = args.get("reason", "Customer requested")
3
    self.log.info(f"Escalating call: {reason}")
4
5
    return (
6
        FunctionResult(
7
            "I understand you'd like to speak with a person. "
8
            "Let me transfer you to one of our team members.",
9
            post_process=True
10
        )
11
        .connect("+15551234567", final=True)
12
    )

1
def route_to_queue(self, args, raw_data):
2
    issue_type = args.get("issue_type", "general")
3
4
    QUEUES = {
5
        "billing": "+15551111111",
6
        "technical": "+15552222222",
7
        "sales": "+15553333333",
8
        "general": "+15554444444"
9
    }
10
11
    queue_number = QUEUES.get(issue_type, QUEUES["general"])
12
13
    return (
14
        FunctionResult(f"Routing you to our {issue_type} team.")
15
        .connect(queue_number, final=True)
16
    )

1
def handoff_to_specialist(self, args, raw_data):
2
    specialty = args.get("specialty")
3
4
    SPECIALIST_AGENTS = {
5
        "billing": "https://agents.example.com/billing",
6
        "technical": "https://agents.example.com/technical",
7
        "sales": "https://agents.example.com/sales"
8
    }
9
10
    if specialty not in SPECIALIST_AGENTS:
11
        return FunctionResult(
12
            "I don't have a specialist for that area. Let me help you directly."
13
        )
14
15
    return (
16
        FunctionResult(
17
            f"I'm connecting you with our {specialty} specialist.",
18
            post_process=True
19
        )
20
        .swml_transfer(
21
            dest=SPECIALIST_AGENTS[specialty],
22
            final=True
23
        )
24
    )