NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Teltel connects to a Nagent workspace with an API key. Once it is connected, agents can call 26 Teltel actions, such as "Create Autodialer Custom Status", "Create Call" and "Create User Status". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Teltel, with input parameters and output schema.
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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Phone number of the caller in E.164 format (e.g., +1234567890)
Phone number of the destination in E.164 format (e.g., +0987654321)
Phone number to display as caller ID to destination (must be a valid phone number in E.164 format, e.g., +0987654321)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
User status data containing name and value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The unique identifier of the autodialer custom status to delete. Use the GET /autodialers/attributes/custom-statuses endpoint to retrieve available status IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
User status ID to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Page number to retrieve
Number of results per page (max 100)
Search by phone number or contact name
Filter by call status (e.g., completed, missed)
Filter by call direction
Sort by this field (e.g., start_time)
Sort order: asc or desc
End datetime filter (ISO 8601)
Start datetime filter (ISO 8601)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Country resource ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Sorting field. Use '-' prefix for descending order. Multiple fields separated by comma. Default is '-id'.
Maximum number of results to return. Default is 500, max is 5000.
Comma-separated list of fields to return. Leave empty for default fields.
Filter expression. Multiple filters separated by comma. Examples: 'created_at>2021-01-01T10:00:00', 'from=37126222222', 'state=DONE'.
Number of results to skip before returning. Default is 0.
Type of SMS messages to retrieve: 'outbox' for sent messages, 'inbox' for received messages.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
User ID to retrieve caller ID groups for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Number of users to fetch, between 1 and 100. Defaults to 30 if not provided.
Offset for pagination, must be >= 0. Defaults to 0 if not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Autodialer campaign ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Autodialer campaign ID
Sorting field(s). Use '-' prefix for descending order. Multiple fields separated by comma. Default is '-id'. Available sort fields: 'id', 'start_time', 'phone_number'.
Maximum number of results to return. Default is 500 if not specified.
Comma-separated list of fields to return. Leave empty for default fields.
Filter expression. Multiple filters separated by comma. Examples: 'start_time>2021-01-01T10:00:00', 'phone_number=37100000000'.
Number of results to skip before returning. Default is 0 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Return only specified fields in response. Leave empty to return default fields. Example: 'id,name,created_at,campaign_type'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Country resource ID for which to retrieve price groups.
Maximum number of results to return. Default is 100 if not specified.
Filter expression to narrow results. Multiple filters separated by comma. Examples: 'price_setup<10,price_month<5', 'prefix=371,type=mobile'.
Number of results to skip before returning. Default is 0 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Maximum number of results to return. Default is 50 if not specified.
Filter expression to narrow results. Multiple filters separated by comma. Examples: 'activated=1,auto_renew=0', 'sms_support=1,number_prefix=371'.
Number of results to skip before returning. Default is 0 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Defines a filter field. Only 'status' field is supported for filtering. Example: 'status=new' or 'status=completed'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Phone number with country prefix. Multiple numbers must be separated by comma.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELTEL_RECEIVE_INBOUND_SMSTool 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
Destination number that received the SMS (your TelTel number)
Timestamp of when the SMS was received (ISO 8601 format)
Unique message identifier provided by TelTel
Content of the received SMS message
Type of message encoding (e.g., utf-8)
Sender's phone number who sent the SMS
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Data object containing the status ID to set.
User ID whose status to update. Use GetUsersList action to retrieve valid user IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Autodialer custom status ID to update. Use GET /autodialers/attributes/custom-statuses to retrieve available IDs.
The new value/name for the autodialer custom status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Status ID to update. Get available status IDs using the Get User Statuses endpoint.
User status data to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 26 Teltel actions on Nagent, including "Create Autodialer Custom Status", "Create Call" and "Create User Status". Create Autodialer Custom Status: Create a custom status for autodialer contacts. Each action is listed on this page with its input parameters and its output.
Teltel connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Autodialer Custom Status takes 1 required input: value. It returns data, error and successful.