Crear acciones personalizadas para el Marketplace

​

1. Información de la acción

​

2. Campos de la acción

​

Crear un campo

• Nombre: la etiqueta del campo.
• Tipo: String, Numérico, Área de texto, Selección, Selección múltiple, Radio, Interruptor (Toggle), Casilla, Adjunto, Editor de texto enriquecido, Oculto o Dinámico.
• Obligatorio: actívalo si el campo es requerido.
• Referencia: clave única a la que se asocia el valor, por ejemplo action_a_name.
• Valor predeterminado: valor fijo o asignado que se carga por defecto en el flujo.
• Altera campo dinámico: si está activo, cualquier cambio en este campo vuelve a cargar los campos dinámicos de la acción.

​

Opciones de Selección, Selección múltiple y Radio

• Constantes: pares etiqueta y valor que defines tú.
• Referencia interna: opciones que vienen de un módulo interno de Chateea.
• API externa: opciones que devuelve tu endpoint mediante GET. Puedes añadir encabezados. La respuesta debe tener esta estructura:

{
  "options": [
    { "label": "Argentina", "value": "AR" },
    { "label": "Chile", "value": "CL" },
    { "label": "México", "value": "MX" }
  ]
}

​

Campo oculto

​

Campo dinámico

{
  "data": {
    "name": "Juan Pérez",
    "age": "29",
    "hobbies": ["sports", "music"],
    "country": "MX",
    "profileType": "public",
    "dataShare": true
  },
  "extras": {
    "locationId": "xyz",
    "contactId": "abc",
    "workflowId": "def"
  },
  "meta": {
    "key": "custom_action_key",
    "version": "1.0"
  }
}

{
  "inputs": [
    {
      "section": "Datos personales",
      "fields": [
        { "field": "name", "title": "Nombre", "fieldType": "string", "required": true },
        { "field": "age", "title": "Edad", "fieldType": "numerical", "required": true },
        {
          "field": "gender",
          "title": "Género",
          "fieldType": "select",
          "required": true,
          "options": [
            { "label": "Masculino", "value": "male" },
            { "label": "Femenino", "value": "female" }
          ]
        }
      ]
    }
  ]
}

​

Reglas de validación

1. Reglas predefinidas: correo, teléfono, URL, números y detección de sintaxis de variables.
2. Expresiones regulares: valida contra un patrón propio.
3. Función flecha: una función que recibe el valor y devuelve true o false.

​

3. Varias ramas (Multi-branch)

• Sección de ramas y su descripción.
• Etiqueta y texto de ayuda del nombre de la rama.
• Título y descripción del aviso al eliminar una rama.
• Permitir nuevas ramas: el usuario puede añadir ramas.
• Ramas predefinidas editables: el usuario puede editar las ramas que tú definiste.
• Mostrar sección de ramas: muestra u oculta la sección al usuario.

​

4. Ejecución de la acción

​

API

​

Código personalizado

• Probar el código es obligatorio: sin una prueba, la salida no se puede usar en pasos posteriores.
• Haz clic en Probar código. Verás “Test Result Success” si funciona o “Test Result Failed” si hay que corregir algo.
• Usa Formatear código para ordenarlo.

​

5. Pausar la ejecución

• Ejecución síncrona (pausa desactivada, con ramas): el contacto pasa a la rama indicada en la propiedad branchId de la respuesta de tu API o del return de tu código.
• Ejecución asíncrona: el branchId se envía en la llamada al webhook de reanudación, según los detalles que muestra Mostrar detalles de la API.

​

6. Datos de respuesta y variables personalizadas

• En Datos de respuesta, pega un ejemplo válido del JSON que devuelve tu endpoint. Se admiten arreglos, que luego pueden usarse en funciones de matriz, código personalizado y webhooks personalizados.
• En Gestionar variables personalizadas, crea variables a partir de ese ejemplo: pon un nombre y elige la referencia dentro de la respuesta. Los usuarios podrán usarlas en los pasos siguientes del flujo.
• Para los valores de entrada, el usuario puede elegir entre un valor estándar (según el tipo de campo) o el selector de valores personalizados (por ejemplo, datos de un webhook entrante o campos personalizados).

​

7. Publicar y mantener la acción

• Enviar a revisión: cada versión empieza como borrador. Cuando termines, haz clic en Enviar a revisión y añade el registro de cambios. Al aprobarse, la versión se publica para todas las cuentas que tienen tu aplicación.
• Nueva versión: con + Nueva versión se crea un borrador con los datos de la versión publicada.
• Eliminar acción: escribe el nombre de la acción para confirmar. Se elimina de forma permanente, desaparece del Marketplace y del listado de acciones, y los flujos que la usaban se saltarán ese paso.

​

Artículos relacionados