LangChain integration

dial-langchain packages Dial’s operations as LangChain tools, so an agent can send messages and place calls as part of its reasoning.

Install

$
pip install dial-langchain

This pulls in dial-sdk and langchain-core.

Available tools

Each tool takes your shared DialClient (client=):

Give the tools to an agent

Build one DialClient, hand it to DialToolkit, and call get_tools() to give the agent the full set, no per-tool imports. Every tool shares that one client (a single connection pool):

1
from dial_sdk import DialClient, DialConfig
2
from dial_langchain import DialToolkit
3
from langchain.chat_models import init_chat_model
4
from langgraph.prebuilt import create_react_agent
5
6
model = init_chat_model("claude-sonnet-4-6", model_provider="anthropic")
7
8
dial = DialClient(DialConfig(api_key="sk_live_..."))
9
toolkit = DialToolkit(client=dial)
10
agent = create_react_agent(model, toolkit.get_tools())

DialToolkit is a standard LangChain BaseToolkit, so get_tools() works anywhere a list of tools is expected.

Or pick individual tools

When you only want a subset, import the tools directly and pass them the same client:

1
from dial_sdk import DialClient, DialConfig
2
from dial_langchain import ListNumbersTool, SendMessageTool, MakeCallTool
3
4
dial = DialClient(DialConfig(api_key="sk_live_..."))
5
tools = [
6
    ListNumbersTool(client=dial),
7
    SendMessageTool(client=dial),
8
    MakeCallTool(client=dial),
9
]
10
11
# Bind to any tool-calling model or agent
12
llm_with_tools = llm.bind_tools(tools)

The tools are async — LangChain calls them via ainvoke. SendMessageTool expects to, a from-number (from_number — ID, owned E.164, or nickname — or the legacy from_number_id), and body; MakeCallTool expects to, a from-number, outbound_instruction, and optionally language and idempotency_key.

Receiving events

Inbound events aren’t a tool — they’re an ingress stream, not something the agent “calls.” To react to inbound SMS or completed calls, use the Python SDK’s new_events_connection() directly — a presence-based stream (not at-least-once — for durable delivery, register a webhook) — and feed events into your agent however suits your app:

1
from dial_sdk import DialClient, DialConfig
2
3
dial = DialClient(DialConfig(api_key="sk_live_..."))
4
async with dial.new_events_connection() as conn:
5
    async for event in conn:
6
        ...  # route the event into your agent