Using SIP Tools in 008 Agent

Tip

📌 These tools are exclusively available for SIP deployments in 008 Agent and allow agents to manage live calls in real time.

In the SIP environment of 008 Agent, you can use native tools to manage the ongoing call. These tools are automatically triggered from your prompts for call transfers. However, if a tool requires the call to be placed on hold during its execution, this must be explicitly stated in the tool’s JSON Schema description.

---

🔧 Available SIP Tools

Tool Name	Description
hangUp	Ends the current call.
call_transfer	Transfers the call to another extension or agent.
call_hold	Places the call on hold. Should be used only if another tool explicitly requires it.
call_unhold	Resumes a previously held call.
call_info	Retrieves call information: caller number, current time, CDR data, etc. Ideal for contextual logic.

---

✅ Best Practices

• Always use call_hold when a tool’s description specifies it.
• Do not call call_unhold until the previous tool has responded.
• For transfers, it’s enough to specify in the prompt which extension to transfer to.

---

🔄 Example of a Tool Requiring Call Hold (call_hold)

{
  "name": "consultar_conocimiento_008",
  "parameters": {
    "type": "object",
    "description": "You must ALWAYS use call_hold when invoking this tool, placing the call on hold until the response is received. Do not use call_unhold until you have the answer.",
    "properties": {
      "query": {
        "type": "string",
        "description": "This will contain the user's question"
      }
    },
    "required": ["query"]
  }
}

☝️ In this case, the call must automatically be placed on hold when the tool is invoked, and it should not be resumed until a response is received via call_unhold.

🔁 Transfer Logic Example

When a user requests to speak with a specific team, use call_transfer specifying the appropriate extension.

🧑‍💻 Prompt Example:

"If the user asks to speak with the support team,
transfer the call to extension 2202 and mention you are
transferring the call to the 008 Agent support team."

By using these tools, your Agent becomes a fully capable live call operator — managing holds, transfers, and contextual data to provide a seamless voice experience.