Skip to main content
Teltel logo
  • Category: phone & sms
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 0
  • Slug: TELTEL
  • Version: 20261101_00

Tools

Slug: TELTEL_CREATE_AUTODIALER_CUSTOM_STATUSTool 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

string
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_CREATE_CALLTool 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

string
required
Phone number of the caller in E.164 format (e.g., +1234567890)
string
required
Phone number of the destination in E.164 format (e.g., +0987654321)
string
required
Phone number to display as caller ID to destination (must be a valid phone number in E.164 format, e.g., +0987654321)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_CREATE_USER_STATUSTool to create a user status in TelTel. Use when you need to add a new status option for users.

Input Parameters

object
required
User status data containing name and value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_DELETE_AUTODIALER_CUSTOM_STATUSTool to delete an autodialer custom status by ID. Use when you need to remove a custom status from your autodialer configuration.

Input Parameters

integer
required
The unique identifier of the autodialer custom status to delete. Use the GET /autodialers/attributes/custom-statuses endpoint to retrieve available status IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_DELETE_USER_STATUSTool to delete a user status by ID. Use when you need to remove an existing user status from TelTel.

Input Parameters

integer
required
User status ID to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_GET_ACCOUNT_BALANCETool to retrieve the account balance for your TelTel account. Use when you need to check available credit or account balance information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_GET_CALL_LISTTool to retrieve a list of calls with details (duration, time, status). Use when you need to filter and page through call records.

Input Parameters

integer
Page number to retrieve
integer
Number of results per page (max 100)
Search by phone number or contact name
string
Filter by call status (e.g., completed, missed)
string ("inbound" | "outbound")
Filter by call direction
string
Sort by this field (e.g., start_time)
string ("asc" | "desc")
Sort order: asc or desc
string
End datetime filter (ISO 8601)
string
Start datetime filter (ISO 8601)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_GET_COUNTRYTool 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

integer
required
Country resource ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_GET_SMS_LISTTool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_GET_USER_CID_GROUPSTool 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

integer
required
User ID to retrieve caller ID groups for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_GET_USERS_LISTTool to retrieve a list of users from your TelTel account. Use when you need to page through or synchronize user records.

Input Parameters

integer
Number of users to fetch, between 1 and 100. Defaults to 30 if not provided.
integer
Offset for pagination, must be >= 0. Defaults to 0 if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_AUTODIALER_ACTIONSTool 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

integer
required
Autodialer campaign ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_AUTODIALER_CONTACTSTool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_AUTODIALER_CUSTOM_STATUSESTool to retrieve list of autodialer custom statuses. Use when you need to view all available custom statuses for autodialer campaigns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_AUTO_DIALERSTool to retrieve a list of autodialer campaigns from TelTel. Use when you need to view all autodialer campaigns and their details.

Input Parameters

string
Return only specified fields in response. Leave empty to return default fields. Example: ‘id,name,created_at,campaign_type’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_AVAILABLE_COUNTRIESTool 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

string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_COUNTRY_PRICE_GROUPSTool 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

integer
required
Country resource ID for which to retrieve price groups.
integer
Maximum number of results to return. Default is 100 if not specified.
string
Filter expression to narrow results. Multiple filters separated by comma. Examples: ‘price_setup<10,price_month<5’, ‘prefix=371,type=mobile’.
integer
Number of results to skip before returning. Default is 0 if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_DEVICESTool to retrieve a list of devices from your TelTel account. Use when you need to view all registered devices and their connection status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_MY_NUMBERSTool 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

integer
Maximum number of results to return. Default is 50 if not specified.
string
Filter expression to narrow results. Multiple filters separated by comma. Examples: ‘activated=1,auto_renew=0’, ‘sms_support=1,number_prefix=371’.
integer
Number of results to skip before returning. Default is 0 if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_ORDERSTool 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

string
Defines a filter field. Only ‘status’ field is supported for filtering. Example: ‘status=new’ or ‘status=completed’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LIST_USER_STATUSESTool to retrieve a list of all user statuses in TelTel. Use when you need to view available status options for users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_LOOKUP_PHONE_NUMBERTool 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

string
required
Phone number with country prefix. Multiple numbers must be separated by comma.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_RECEIVE_INBOUND_SMSTransform supplied inbound SMS webhook fields into structured message details for further processing. The caller supplies the notification data to the action.

Input Parameters

string
required
Destination number that received the SMS (your TelTel number)
string
required
Timestamp of when the SMS was received (ISO 8601 format)
string
required
Unique message identifier provided by TelTel
string
required
Content of the received SMS message
string
Type of message encoding (e.g., utf-8)
string
required
Sender’s phone number who sent the SMS

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_SET_USER_STATUSTool to set a user’s status in TelTel. Use when you need to update a user’s availability or activity status.

Input Parameters

object
required
Data object containing the status ID to set.
integer
required
User ID whose status to update. Use GetUsersList action to retrieve valid user IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_UPDATE_AUTODIALER_CUSTOM_STATUSTool to update an autodialer custom status value by ID. Use when you need to rename or modify an existing custom status label.

Input Parameters

integer
required
Autodialer custom status ID to update. Use GET /autodialers/attributes/custom-statuses to retrieve available IDs.
string
required
The new value/name for the autodialer custom status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TELTEL_UPDATE_USER_STATUSTool 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

integer
required
Status ID to update. Get available status IDs using the Get User Statuses endpoint.
object
required
User status data to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not