Create a Voice Action

post

https://api.liguelead.com.br/v1/voice-action

Creates a voice action for the authenticated client. The required credentials and config fields depend on the type/provider combination:

SCHEDULE_EVENT (microsoft): requires credentials and config.destination (e-mail). config.calendar_id and config.timezone are optional.
TRANSFER_CALL (internal): requires the top-level phone field (10–16 digits).
HTTP_WEBHOOK (internal): requires the top-level endpoint (HTTPS URL); the authorization_token field is optional. At the end of the call a webhook with summarized call data is sent to endpoint, using authorization_token for authorization when provided.

Microsoft credentials: tenant, client_id, client_secret. A maximum of 50 actions per client is enforced.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create payload. Required credentials/config/phone/endpoint/authorization_token depend on the type/provider combination — see the endpoint description.

name

string

required

length ≤ 100

type

string

enum

required

Allowed:

provider

string

enum

required

Allowed:

credentials

config

object

Action configuration. destination is required for SCHEDULE_EVENT; from_address and destination are required for SEND_EMAIL.

phone

string

Required for TRANSFER_CALL (10–16 digits).

endpoint

uri

Required for HTTP_WEBHOOK. HTTPS URL the webhook is POSTed to at the end of the call (max 2048 characters).

authorization_token

string

Optional for HTTP_WEBHOOK. Authorization token sent in the webhook request to the client endpoint when provided (max 2048 characters).

Responses

201Voice action created

400Maximum number of actions (50) reached for this client.

422Validation error (invalid type/provider combination, missing required config/credentials, or invalid e-mail/phone/URL — the HTTP_WEBHOOK endpoint must be a valid HTTPS URL).