dial-langchain

Official LangChain tools for Dial — phone numbers, SMS, WhatsApp, and AI voice calls for AI agents.

Install

pip install dial-langchain
# or
uv add dial-langchain

This pulls in dial-sdk and langchain-core automatically. Requires Python 3.11+.

Quickstart

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

from dial_sdk import DialClient, DialConfig
from dial_langchain import DialToolkit
from langchain.chat_models import init_chat_model
from langgraph.prebuilt import create_react_agent

model = init_chat_model("claude-sonnet-4-6", model_provider="anthropic")

dial = DialClient(DialConfig(api_key="sk_live_..."))
toolkit = DialToolkit(client=dial)
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. DialConfig also takes an optional base_url (defaults to https://api.getdial.ai; override it for local or self-hosted setups).

Pick individual tools

When you only want a subset, import the tools directly and pass them the same client. Each Dial capability is a LangChain BaseTool:

from dial_sdk import DialClient, DialConfig
from dial_langchain import (
    ListNumbersTool,
    SendMessageTool,
    MakeCallTool,
    ListCallsTool,
    GetCallTool,
    WaitForMessageTool,
)

dial = DialClient(DialConfig(api_key="sk_live_..."))
tools = [
    ListNumbersTool(client=dial),
    SendMessageTool(client=dial),
    MakeCallTool(client=dial),
]

# Drop into any LangChain agent:
from langchain.agents import create_react_agent
agent = create_react_agent(model, tools, prompt)

The tools are async — LangChain calls them via ainvoke.

Available tools

Tool	Tool name (for the LLM)
`ListNumbersTool`	`list_numbers`
`PurchaseNumberTool`	`purchase_number`
`SetNumberPropertiesTool`	`set_number_properties`
`ListMessagesTool`	`list_messages`
`ListContactsTool`	`list_contacts`
`SendMessageTool`	`send_message`
`ReplyToMessageTool`	`reply_to_message`
`ListCallsTool`	`list_calls`
`MakeCallTool`	`make_call`
`GetCallTool`	`get_call`
`WaitForMessageTool`	`wait_for_message`

Each tool wraps the corresponding dial-sdk call under the hood. DialToolkit.get_tools() returns all of them.

dial-sdk — the underlying async Python SDK.
Documentation

Release files for dial-langchain 0.22.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dial-langchain 0.22.0
File	Size	Uploaded
dial_langchain-0.22.0.tar.gz	139.6 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dial-langchain 0.22.0
File	Interpreter	ABI	Platform	Reset
dial_langchain-0.22.0-py3-none-any.whl 12.1 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 151.7 kB

Release files / dial_langchain-0.22.0.tar.gz

Download URL	dial_langchain-0.22.0.tar.gz
Size	139.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`42fd4b0bf1db4f695b93cc0c9a534a828b32b9e78544d811dbb4945bc7e5c45d`
BLAKE2b-256 checksum How to use checksums	`ca196280a220a5a0545bb9251056830aee1ff24d1e2bb49aa3b9ff3a9b49d06a`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/GENWAY-AI/dial
Publishing commit: github.com/GENWAY-AI/dial/tree/a58aec707e83df7daba3bb1c6dc2a294d7ae2789

Workflow

Publishing configuration: github.com/GENWAY-AI/dial/blob/a58aec707e83df7daba3bb1c6dc2a294d7ae2789/.github/workflows/publish-sdk-langchain.yml
Publishing logs: github.com/GENWAY-AI/dial/actions/runs/35778458250/attempts/1

Artifact

Subject: dial_langchain-0.22.0.tar.gz
SHA-256 checksum: 42fd4b0bf1db4f695b93cc0c9a534a828b32b9e78544d811dbb4945bc7e5c45d Verifying attestations

Release files / dial_langchain-0.22.0-py3-none-any.whl

Download URL	dial_langchain-0.22.0-py3-none-any.whl
Size	12.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b05d823adc9fe581e1a8fac7f2531a2d5f1bc5cc375e6d6909a9c1c058ca97cf`
BLAKE2b-256 checksum How to use checksums	`7060d86d88bef0e2f54d14e51bb2e5fdaa9a511875243422047db1eef63e503e`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/GENWAY-AI/dial
Publishing commit: github.com/GENWAY-AI/dial/tree/a58aec707e83df7daba3bb1c6dc2a294d7ae2789

Workflow

Publishing configuration: github.com/GENWAY-AI/dial/blob/a58aec707e83df7daba3bb1c6dc2a294d7ae2789/.github/workflows/publish-sdk-langchain.yml
Publishing logs: github.com/GENWAY-AI/dial/actions/runs/35778458250/attempts/1

Artifact

Subject: dial_langchain-0.22.0-py3-none-any.whl
SHA-256 checksum: b05d823adc9fe581e1a8fac7f2531a2d5f1bc5cc375e6d6909a9c1c058ca97cf Verifying attestations