Retell AI

retellai

RetellAI captures calls and transcripts, enabling businesses to analyze conversations, extract insights, and enhance customer interactions in one centralized platform

Artificial Intelligence Transcription Phone & SMS Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (10)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Buy a new phone number bind agentsRETELLAI_BUY_A_NEW_PHONE_NUMBER_BIND_AGENTSAcción

This endpoint allows purchasing a new phone number with a specified area code and binding it to designated agents for inbound and outbound calls. it requires json with agent ids and area code. responses indicate the creation status or errors.

Parámetros de entrada

nicknamestring
Nickname for the number, for reference only.
area_codeinteger
Area code of the number to obtain. Format is a 3-digit integer, currently supporting only US area codes.
inbound_agent_idstring
Unique id of agent to bind to the number. If null, this number would not accept inbound calls.
outbound_agent_idstring
Unique id of agent to bind to the number. If null, this number would not initiate outbound calls without an agent id override.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a new outbound phone callRETELLAI_CREATE_A_NEW_OUTBOUND_PHONE_CALLAcción

Initiate an outbound call by post to '/v2/create-phone-call'. requires 'from number' and 'to number' in e.164 format. optional overrides and metadata supported. on success, returns call details including type, status, and ids.

Parámetros de entrada

to_numberstringObligatorio
The number you want to call, in E.164 format. Right now only US numbers are officially supported.
from_numberstringObligatorio
The number you own in E.164 format. Must be a Retell managed number.
override_agent_idstring
For this particular call, override the agent used with this agent id. This does not bind the agent to this number, this is for one time override.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a new web callRETELLAI_CREATE_A_NEW_WEB_CALLAcción

The /v2/create-web-call endpoint creates a web call with a unique agent id, returning call details like type, token, call id, and status in json format, with a 201 response. optional metadata and variables can be included.

Parámetros de entrada

agent_idstringObligatorio
Unique id of agent used for the call. Your agent would contain the LLM Websocket url used for this call.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete phone numberRETELLAI_DELETE_PHONE_NUMBERAcción

Deletes an existing phone number identified by its e.164 format.

Parámetros de entrada

phone_numberstringObligatorio
Phone Number

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List all phone numbersRETELLAI_LIST_ALL_PHONE_NUMBERSAcción

Retrieves a list of all phone numbers associated with the account.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve call detailsRETELLAI_RETRIEVE_CALL_DETAILSAcción

The /v2/list-calls endpoint retrieves call records with filters (agent id, timestamps), offers sorting, pagination, and handles different responses (success, bad request, unauthorized, server error) in json format.

Parámetros de entrada

limitinteger
Limit the number of calls returned.
sort_orderstringenum
The calls will be sorted by `start_timestamp`, whether to return the calls in ascending or descending order.
ascendingdescending
pagination_keystring
The pagination key to continue fetching the next page of calls. Pagination key is represented by a call id here, and it"s exclusive (not included in the fetched calls). The last call id from the list calls is usually used as pagination key here. If not set, will start from the beginning.
filter__criteria__agent__idstring[]
Only retrieve calls that are made with specific agent(s).
filter__criteria__after__end__timestampinteger
Inclusive. Filter calls that end on or after this timestamp.
filter__criteria__before__end__timestampinteger
Exclusive. Filter calls that end before this timestamp.
filter__criteria__after__start__timestampinteger
Inclusive. Filter calls that start on or after this timestamp.
filter__criteria__before__start__timestampinteger
Exclusive. Filter calls that start before this timestamp.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve call details by idRETELLAI_RETRIEVE_CALL_DETAILS_BY_IDAcción

Retrieve call details by id for web/phone calls, including type, agent id, status, timestamps, and web access token; covering responses from success to server errors.

Parámetros de entrada

call_idstringObligatorio
Call Id

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve details of a specific phone numberRETELLAI_RETRIEVE_DETAILS_OF_A_SPECIFIC_PHONE_NUMBERAcción

Fetches the details of a given phone number in e.164 format.

Parámetros de entrada

phone_numberstringObligatorio
Phone number in E.164 format (+country code and number with no spaces or special characters).

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve details of a specific voiceRETELLAI_RETRIEVE_DETAILS_OF_A_SPECIFIC_VOICEAcción

"access specific voice details including its name, provider, accent, gender, and a preview audio url using the unique voice id. parameters required."

Parámetros de entrada

voice_idstringObligatorio
Voice Id

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update phone numberRETELLAI_UPDATE_PHONE_NUMBERAcción

Updates the agent bound to a purchased phone number.

Parámetros de entrada

nicknamestring
Nickname of the number for reference only.
phone_numberstringObligatorio
Phone Number
inbound_agent_idstring
Unique id of agent to bind to the number for inbound calls. If null, inbound calls are not accepted.
outbound_agent_idstring
Unique id of agent to bind to the number for outbound calls. If null, outbound calls cannot be initiated without override.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not