API Trigger

API Trigger node позволяет программно инициировать outbound-звонки вашему голосовому агенту. Когда вы добавляете API Trigger node в workflow, Агентика генерирует уникальный endpoint URL, который внешние системы могут вызвать, чтобы начать разговор. Это удобно, если вы хотите запускать звонки из собственного backend, CRM или workflow tools вроде n8n и Zapier.

Требования

Настроенный telephony provider — без него outbound-звонки завершатся ошибкой
API key для authentication

Где найти trigger URL

Когда вы добавляете API Trigger node в workflow, Агентика назначает ему уникальный UUID. Trigger node предоставляет два URL с этим UUID:

production URL для опубликованного workflow
test URL для последнего draft

Любой из URL можно скопировать из settings dialog trigger node.

POST https://your-agentika-instance/api/v1/public/agent/{uuid}        # Production
POST https://your-agentika-instance/api/v1/public/agent/test/{uuid}   # Test

Если вы используете hosted version, замените your-agentika-instance на api.agentika.ai.

Test vs production

Mode	URL	Runs
Production	`/api/v1/public/agent/{uuid}`	Опубликованная версия агента.
Test	`/api/v1/public/agent/test/{uuid}`	Последний draft. Если draft отсутствует, используется опубликованная версия.

Используйте test URL, пока дорабатываете изменения, чтобы production traffic продолжал идти в опубликованную версию. Production URL выполняет только published workflow. Если вы обновили workflow, но не опубликовали его, production trigger продолжит запускать старую опубликованную версию. После публикации draft оба URL запускают одно и то же definition.

Частая ошибка: отредактировать workflow, сохранить draft и вызвать production trigger URL, ожидая новое поведение. Оно не появится, пока вы не опубликуете workflow. Используйте test URL, чтобы проверить draft перед публикацией.

Body, headers и shape response одинаковы для обоих URL.

Выполнение запроса

Аутентифицируйтесь, передав API key в заголовке X-API-Key. Body запроса требует phone_number и принимает необязательные поля initial_context и telephony_configuration_id.

curl -X POST https://your-agentika-instance/api/v1/public/agent/{uuid} \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dg_your_api_key" \
  -d '{
    "phone_number": "+14155550100",
    "initial_context": {
      "customer_name": "Jane",
      "appointment_date": "March 15"
    }
  }'

curl -X POST https://your-agentika-instance/api/v1/public/agent/test/{uuid} \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dg_your_api_key" \
  -d '{
    "phone_number": "+14155550100",
    "initial_context": {
      "customer_name": "Jane",
      "appointment_date": "March 15"
    }
  }'

Используйте test URL, если хотите проверить draft changes до публикации.

Response

Успешный request возвращает workflow_run_id, по которому можно получить run details, recordings и transcripts.

{
  "status": "initiated",
  "workflow_run_id": 12345,
  "workflow_run_name": "WR-API-7823"
}

Error responses

Status	Cause
`400`	Telephony provider не настроен или звонок не удалось инициировать
`401`	API key отсутствует или недействителен
`403`	API key не имеет доступа к этому agent
`404`	Trigger не найден или не активен

Initial context

initial_context — JSON object с любой информацией, к которой голосовой агент должен иметь доступ во время звонка. Эти значения можно использовать в prompts через template variables: значения в {{ и }}. Например, если request содержит:

{
    "phone_number": "+14155550100",
    "initial_context": {
        "user": {
            "name": "John"
        }
    }
}

Имя пользователя можно использовать в agent prompt как {{user.name}}: в Agent prompts поля initial_context указываются напрямую по имени, без префикса initial_context.. Точный синтаксис для prompts и webhook payloads см. в template variables. Подробнее о потоке данных через звонок см. Context и переменные.

Выбор telephony configuration

По умолчанию звонки выполняются через default outbound telephony configuration вашей организации. Чтобы направить конкретный звонок через другую configuration, например с регионального номера, передайте telephony_configuration_id в body запроса.

{
  "phone_number": "+14155550100",
  "telephony_configuration_id": 42
}

ID отображается в каждой строке Telephony configurations (https://app.agentika.ai/telephony-configurations для hosted или http://localhost:3010/telephony-configurations для local). Configuration должна принадлежать той же organization, что и API Trigger, иначе request вернет 404.

Полные детали endpoint, включая все parameters и response fields, см. в API reference.

Начало работы

Основные понятия

Конфигурации

Конструктор голосовых агентов

Телефония

Интеграции

Требования

Где найти trigger URL

Test vs production

Выполнение запроса

Response

Error responses

Initial context

Выбор telephony configuration

​Требования

​Где найти trigger URL

​Test vs production

​Выполнение запроса

​Response

​Error responses

​Initial context

​Выбор telephony configuration

Требования

Где найти trigger URL

Test vs production

Выполнение запроса

Response

Error responses

Initial context

Выбор telephony configuration