Metadata-Version: 2.4
Name: crewai-agentphone
Version: 0.1.0
Summary: CrewAI integration for AgentPhone — telephony tools for AI agents
Project-URL: Homepage, https://agentphone.to
Project-URL: Documentation, https://docs.agentphone.to
Project-URL: Repository, https://github.com/AgentPhone-AI/crewai-agentphone
Project-URL: PyPI, https://pypi.org/project/crewai-agentphone/
Author-email: AgentPhone <support@agentphone.to>
License: MIT
License-File: LICENSE
Keywords: agentphone,ai-agents,crewai,sms,telephony,voice
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <4.0,>=3.10
Requires-Dist: agentphone<1.0.0,>=0.5.0
Requires-Dist: crewai<2.0.0,>=0.80.0
Description-Content-Type: text/markdown

# crewai-agentphone

[![PyPI version](https://img.shields.io/pypi/v/crewai-agentphone)](https://pypi.org/project/crewai-agentphone/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

CrewAI integration for [AgentPhone](https://agentphone.to) — telephony tools that let AI agents send SMS messages, make phone calls, and manage phone numbers.

## Installation

```bash
pip install crewai-agentphone
```

## Setup

Get your API key from [agentphone.to](https://agentphone.to) and set it as an environment variable:

```bash
export AGENTPHONE_API_KEY="your-api-key"
```

## Quick Start

### Use all tools with an agent

```python
from crewai import Agent
from crewai_agentphone import AgentPhoneToolkit

toolkit = AgentPhoneToolkit()

agent = Agent(
    role="Sales Caller",
    goal="Call leads and send follow-up texts",
    tools=toolkit.get_tools(),
)
```

### Use specific tools

```python
from crewai_agentphone import AgentPhoneToolkit

toolkit = AgentPhoneToolkit(selected_tools=["send_sms", "make_call"])
tools = toolkit.get_tools()
```

### Use individual tools

```python
from crewai_agentphone import AgentPhoneSendSMS

tool = AgentPhoneSendSMS()
result = tool.run(
    number_id="num_abc123",
    to_number="+14155551234",
    body="Hello from CrewAI!"
)
```

### Full crew example

```python
from crewai import Agent, Task, Crew
from crewai_agentphone import AgentPhoneToolkit

toolkit = AgentPhoneToolkit()

caller = Agent(
    role="Outbound Caller",
    goal="Call leads to schedule demos",
    backstory="You are a friendly sales rep who calls prospects to schedule product demos.",
    tools=toolkit.get_tools(),
)

task = Task(
    description="Call +14155551234 and schedule a demo for next week",
    expected_output="Call transcript and confirmation of scheduled demo",
    agent=caller,
)

crew = Crew(agents=[caller], tasks=[task])
result = crew.kickoff()
```

## Available Tools

| Tool | Name | Description |
|------|------|-------------|
| `AgentPhoneSendSMS` | `agentphone_send_sms` | Send an SMS message |
| `AgentPhoneMakeCall` | `agentphone_make_call` | Make an AI-powered outbound call |
| `AgentPhoneGetTranscript` | `agentphone_get_transcript` | Get a call transcript |
| `AgentPhoneListCalls` | `agentphone_list_calls` | List phone calls |
| `AgentPhoneListConversations` | `agentphone_list_conversations` | List SMS conversations |
| `AgentPhoneGetConversation` | `agentphone_get_conversation` | Get conversation with messages |
| `AgentPhoneBuyNumber` | `agentphone_buy_number` | Buy a phone number |
| `AgentPhoneListNumbers` | `agentphone_list_numbers` | List phone numbers |
| `AgentPhoneCreateAgent` | `agentphone_create_agent` | Create an AI phone agent |
| `AgentPhoneListAgents` | `agentphone_list_agents` | List AI phone agents |
| `AgentPhoneCreateContact` | `agentphone_create_contact` | Create a contact |
| `AgentPhoneListContacts` | `agentphone_list_contacts` | List contacts |

## API Reference

See the [AgentPhone documentation](https://docs.agentphone.to) for full API details.
