Crear una acción HTTP

POST

/integrations/http-actions

curl --request POST \
  --url https://api.matiasimpulso.com/integrations/http-actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "slug": "consultar_pedido", "description": "example", "method": "GET", "urlTemplate": "https://api.ejemplo.com/pedidos/{{pedido_id}}", "headers": { "additionalProperty": "example" }, "signingSecret": "example", "inputSchema": {}, "outputMapping": [ { "path": "pedido.estado", "as": "estado" } ], "kind": "read", "requiresConfirmation": true, "requiresIdentityBinding": false, "timeoutMs": 1, "isActive": true }'

• Servidor de Producción (Cloud)
• Entorno de Desarrollo Local

Authorizations

• bearer

Request Body^required

Media type application/json

object

slug

required

Nombre de la herramienta; no se puede cambiar

string

<= 64 characters

Example

consultar_pedido

description

required

Cuándo llamarla y qué devuelve

string

<= 2000 characters

method

required

string

Allowed values: GET POST PUT PATCH DELETE

urlTemplate

required

string

<= 2048 characters

Example

https://api.ejemplo.com/pedidos/{{pedido_id}}

headers

Cabeceras. Se cifran y nunca se devuelven.

object

key

additional properties

string

signingSecret

Secreto de la firma HMAC. Se cifra y nunca se devuelve.

string

nullable >= 16 characters <= 512 characters

inputSchema

required

JSON Schema cerrado de los argumentos

object

key

additional properties

any

outputMapping

Array<object>

object

path

required

Ruta en la respuesta JSON

string

<= 200 characters

Example

pedido.estado

as

Nombre con el que lo ve el agente

string

<= 50 characters

Example

estado

kind

required

string

Allowed values: read effect

requiresConfirmation

Por defecto, true en effect. En read siempre es false.

boolean

requiresIdentityBinding

SEC2-25: solo se ejecuta con la identidad verificada del cliente. Exige {{sys.contact_phone}} o {{sys.contact_id}} en la URL o en una cabecera.

boolean

timeoutMs

number

>= 100 <= 30000

isActive

boolean

Responses

201

Acción creada

400

Definición no válida

403

Requiere perfil de administrador

409

Ya existe una acción con ese slug

503

Cifrado de integraciones sin configurar