# Teltel

TelTel is a telecom operator and software provider offering tools for automated voice and SMS communication, including cloud-based contact center software, Voice/SMS API, VoIP/SIP trunking, auto dialer, webphone integration, Click2Call, and webhook-based call event tracking for CRM integration.

- **Category:** phone & sms
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 26
- **Triggers:** 0
- **Slug:** `TELTEL`
- **Version:** 20260227_00

## Tools

### Create Autodialer Custom Status

**Slug:** `TELTEL_CREATE_AUTODIALER_CUSTOM_STATUS`

Tool to create a custom status for autodialer contacts. Use when you need to add a new status option that agents can use to categorize contacts in the Operator Dashboard.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | string | Yes | The name/value of the custom status to create. This status will be available for agents to use when categorizing contacts in the Operator Dashboard. Maximum 32 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Call

**Slug:** `TELTEL_CREATE_CALL`

Tool to create a call between two participants. Use when you need to initiate an outbound call connecting a caller to a destination number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `caller_number` | string | Yes | Phone number of the caller in E.164 format (e.g., +1234567890) |
| `destination_number` | string | Yes | Phone number of the destination in E.164 format (e.g., +0987654321) |
| `destination_displayname` | string | Yes | Phone number to display as caller ID to destination (must be a valid phone number in E.164 format, e.g., +0987654321) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Status

**Slug:** `TELTEL_CREATE_USER_STATUS`

Tool to create a user status in TelTel. Use when you need to add a new status option for users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | User status data containing name and value. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Autodialer Custom Status

**Slug:** `TELTEL_DELETE_AUTODIALER_CUSTOM_STATUS`

Tool to delete an autodialer custom status by ID. Use when you need to remove a custom status from your autodialer configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the autodialer custom status to delete. Use the GET /autodialers/attributes/custom-statuses endpoint to retrieve available status IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Status

**Slug:** `TELTEL_DELETE_USER_STATUS`

Tool to delete a user status by ID. Use when you need to remove an existing user status from TelTel.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | User status ID to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Balance

**Slug:** `TELTEL_GET_ACCOUNT_BALANCE`

Tool to retrieve the account balance for your TelTel account. Use when you need to check available credit or account balance information.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Call List

**Slug:** `TELTEL_GET_CALL_LIST`

Tool to retrieve a list of calls with details (duration, time, status). Use when you need to filter and page through call records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve |
| `limit` | integer | No | Number of results per page (max 100) |
| `search` | string | No | Search by phone number or contact name |
| `status` | string | No | Filter by call status (e.g., completed, missed) |
| `direction` | string ("inbound" | "outbound") | No | Filter by call direction |
| `sort_field` | string | No | Sort by this field (e.g., start_time) |
| `sort_order` | string ("asc" | "desc") | No | Sort order: asc or desc |
| `to_datetime` | string | No | End datetime filter (ISO 8601) |
| `from_datetime` | string | No | Start datetime filter (ISO 8601) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Country

**Slug:** `TELTEL_GET_COUNTRY`

Tool to retrieve country resource information by ID from TelTel. Use when you need to fetch details about a specific country for DID number provisioning.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Country resource ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SMS List

**Slug:** `TELTEL_GET_SMS_LIST`

Tool to retrieve a list of sent (outbox) or received (inbox) SMS messages from TelTel. Use when you need to filter or paginate through SMS message history. Supports filtering by date, sender, recipient, and message state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sorting field. Use '-' prefix for descending order. Multiple fields separated by comma. Default is '-id'. |
| `limit` | integer | No | Maximum number of results to return. Default is 500, max is 5000. |
| `fields` | string | No | Comma-separated list of fields to return. Leave empty for default fields. |
| `filter` | string | No | Filter expression. Multiple filters separated by comma. Examples: 'created_at>2021-01-01T10:00:00', 'from=37126222222', 'state=DONE'. |
| `offset` | integer | No | Number of results to skip before returning. Default is 0. |
| `message_type` | string ("outbox" | "inbox") | No | Type of SMS messages to retrieve: 'outbox' for sent messages, 'inbox' for received messages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Caller ID Groups

**Slug:** `TELTEL_GET_USER_CID_GROUPS`

Tool to retrieve caller ID groups for a specific user. Use when you need to fetch the list of CID groups associated with a user account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | User ID to retrieve caller ID groups for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Users List

**Slug:** `TELTEL_GET_USERS_LIST`

Tool to retrieve a list of users from your TelTel account. Use when you need to page through or synchronize user records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of users to fetch, between 1 and 100. Defaults to 30 if not provided. |
| `offset` | integer | No | Offset for pagination, must be >= 0. Defaults to 0 if not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Autodialer Actions

**Slug:** `TELTEL_LIST_AUTODIALER_ACTIONS`

Tool to retrieve the action history for an autodialer campaign. Use when you need to view the list of actions performed on a specific autodialer campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Autodialer campaign ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Autodialer Contacts

**Slug:** `TELTEL_LIST_AUTODIALER_CONTACTS`

Tool to retrieve the contact list for an autodialer campaign. Use when you need to view contacts, filter by phone number or start time, or paginate through campaign contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Autodialer campaign ID |
| `sort` | string | No | Sorting field(s). Use '-' prefix for descending order. Multiple fields separated by comma. Default is '-id'. Available sort fields: 'id', 'start_time', 'phone_number'. |
| `limit` | integer | No | Maximum number of results to return. Default is 500 if not specified. |
| `fields` | string | No | Comma-separated list of fields to return. Leave empty for default fields. |
| `filter` | string | No | Filter expression. Multiple filters separated by comma. Examples: 'start_time>2021-01-01T10:00:00', 'phone_number=37100000000'. |
| `offset` | integer | No | Number of results to skip before returning. Default is 0 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Autodialer Custom Statuses

**Slug:** `TELTEL_LIST_AUTODIALER_CUSTOM_STATUSES`

Tool to retrieve list of autodialer custom statuses. Use when you need to view all available custom statuses for autodialer campaigns.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Autodialer Campaigns

**Slug:** `TELTEL_LIST_AUTO_DIALERS`

Tool to retrieve a list of autodialer campaigns from TelTel. Use when you need to view all autodialer campaigns and their details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | string | No | Return only specified fields in response. Leave empty to return default fields. Example: 'id,name,created_at,campaign_type' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Available Countries

**Slug:** `TELTEL_LIST_AVAILABLE_COUNTRIES`

Tool to get the list of countries where DID numbers are available for purchase. Use when you need to discover which countries support phone number provisioning or filter countries by pricing and features.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | Filter expression to narrow results. Multiple filters separated by comma. Supported fields: name (country name), number_prefix (country phone prefix), price_setup (setup price), price_month (monthly price), requirement_type (0/1/2 for verification level), sms_support (0/1). Operators: = (equals), < (less than), > (greater than), <= (less or equal), >= (greater or equal). Example: 'name=Latvia,number_prefix=371,price_setup<10,price_month<10,requirement_type=0,sms_support=0' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Country Price Groups

**Slug:** `TELTEL_LIST_COUNTRY_PRICE_GROUPS`

Tool to retrieve phone number price groups available in a specific country. Use when you need to view pricing tiers or filter available phone number groups by country.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Country resource ID for which to retrieve price groups. |
| `limit` | integer | No | Maximum number of results to return. Default is 100 if not specified. |
| `filter` | string | No | Filter expression to narrow results. Multiple filters separated by comma. Examples: 'price_setup<10,price_month<5', 'prefix=371,type=mobile'. |
| `offset` | integer | No | Number of results to skip before returning. Default is 0 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Devices

**Slug:** `TELTEL_LIST_DEVICES`

Tool to retrieve a list of devices from your TelTel account. Use when you need to view all registered devices and their connection status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Numbers

**Slug:** `TELTEL_LIST_MY_NUMBERS`

Tool to retrieve a list of phone numbers (DIDs) owned by the account. Use when you need to view all purchased phone numbers or filter by activation status, auto-renew settings, or SMS/voice support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. Default is 50 if not specified. |
| `filter` | string | No | Filter expression to narrow results. Multiple filters separated by comma. Examples: 'activated=1,auto_renew=0', 'sms_support=1,number_prefix=371'. |
| `offset` | integer | No | Number of results to skip before returning. Default is 0 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List DID Orders

**Slug:** `TELTEL_LIST_ORDERS`

Tool to retrieve a list of DID (phone number) orders from TelTel. Use when you need to check order status, view order history, or filter orders by specific criteria like status or type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | Defines a filter field. Only 'status' field is supported for filtering. Example: 'status=new' or 'status=completed'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Statuses

**Slug:** `TELTEL_LIST_USER_STATUSES`

Tool to retrieve a list of all user statuses in TelTel. Use when you need to view available status options for users.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lookup Phone Number

**Slug:** `TELTEL_LOOKUP_PHONE_NUMBER`

Tool to perform HLR (Home Location Register) lookup for phone numbers via TelTel API. Use when you need to verify phone number validity, check network status, or retrieve carrier information. Supports single or multiple phone numbers in one request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `numbers` | string | Yes | Phone number with country prefix. Multiple numbers must be separated by comma. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Receive Inbound SMS

**Slug:** `TELTEL_RECEIVE_INBOUND_SMS`

Tool to process inbound SMS webhook data from TelTel. Use this to handle incoming SMS notifications that TelTel sends to your configured webhook URL. This action parses and validates the webhook payload, returning the SMS details in a structured format for further processing. Note: TelTel sends inbound SMS data via GET request with query parameters. Configure your webhook URL in TelTel account settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | Yes | Destination number that received the SMS (your TelTel number) |
| `time` | string | Yes | Timestamp of when the SMS was received (ISO 8601 format) |
| `msgid` | string | Yes | Unique message identifier provided by TelTel |
| `message` | string | Yes | Content of the received SMS message |
| `encoding` | string | No | Type of message encoding (e.g., utf-8) |
| `from_number` | string | Yes | Sender's phone number who sent the SMS |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set User Status

**Slug:** `TELTEL_SET_USER_STATUS`

Tool to set a user's status in TelTel. Use when you need to update a user's availability or activity status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data object containing the status ID to set. |
| `user_id` | integer | Yes | User ID whose status to update. Use GetUsersList action to retrieve valid user IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Autodialer Custom Status

**Slug:** `TELTEL_UPDATE_AUTODIALER_CUSTOM_STATUS`

Tool to update an autodialer custom status value by ID. Use when you need to rename or modify an existing custom status label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Autodialer custom status ID to update. Use GET /autodialers/attributes/custom-statuses to retrieve available IDs. |
| `value` | string | Yes | The new value/name for the autodialer custom status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Status

**Slug:** `TELTEL_UPDATE_USER_STATUS`

Tool to update an existing user status in TelTel. Use when you need to modify the name, enabled state, or offline state of a user status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Status ID to update. Get available status IDs using the Get User Statuses endpoint. |
| `data` | object | Yes | User status data to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |