Activepieces + AllSign

Activepieces es una plataforma de automatización empresarial moderna que permite crear flujos de trabajo visuales. Conecta AllSign para automatizar procesos de firma electrónica de manera intuitiva y escalable.

Configuración inicial

1. Crear cuenta en Activepieces

# Usando Docker (self-hosted)
docker run -d \
  --name activepieces \
  -p 80:80 \
  -v activepieces_data:/opt/activepieces/dist/packages/server/api/src/assets \
  activepieces/activepieces:latest

# O usar Activepieces Cloud
# Visita https://cloud.activepieces.com

2. Configurar conexión AllSign

En Activepieces, ve a Connections
Crea nueva conexión HTTP
Configura:
- Name: AllSign API
- Base URL: https://api.enterprise.allsign.io
- Authentication: Bearer Token
- Token: TU_API_KEY_AQUI

Flujos disponibles

Crear documento básico

Trigger: Manual o Webhook Acciones:

Convertir archivo a Base64
Crear documento en AllSign

{
  "displayName": "Crear Documento AllSign",
  "trigger": {
    "type": "WEBHOOK",
    "settings": {
      "inputUiInfo": {
        "currentSelectedData": "sample-data"
      }
    }
  },
  "actions": [
    {
      "name": "convert_to_base64",
      "displayName": "Convertir a Base64",
      "type": "CODE",
      "settings": {
        "sourceCode": "export const code = async (inputs) => {\n  const fileBuffer = inputs.file;\n  const base64 = fileBuffer.toString('base64');\n  return { base64 };\n};"
      }
    },
    {
      "name": "create_document",
      "displayName": "Crear Documento AllSign",
      "type": "HTTP",
      "settings": {
        "url": "https://api.enterprise.allsign.io/v1/documents/create_document_base64",
        "method": "POST",
        "headers": {
          "Authorization": "Bearer {{connections.allsign.token}}",
          "Content-Type": "application/json"
        },
        "body": {
          "document_name": "{{trigger.body.document_name}}",
          "description": "{{trigger.body.description}}",
          "file_base64": "{{convert_to_base64.base64}}",
          "file_name": "{{trigger.body.file_name}}"
        }
      }
    }
  ]
}

Flujo completo con firmantes

Template que incluye creación de documento y envío de invitaciones:

{
  "displayName": "Flujo Completo AllSign",
  "trigger": {
    "type": "WEBHOOK",
    "settings": {
      "inputUiInfo": {
        "currentSelectedData": "sample-data"
      }
    }
  },
  "actions": [
    {
      "name": "convert_file",
      "displayName": "Convertir PDF a Base64",
      "type": "CODE",
      "settings": {
        "sourceCode": "export const code = async (inputs) => {\n  const base64 = Buffer.from(inputs.file, 'binary').toString('base64');\n  return { base64 };\n};"
      }
    },
    {
      "name": "create_document",
      "displayName": "Crear Documento",
      "type": "HTTP",
      "settings": {
        "url": "https://api.enterprise.allsign.io/v1/documents/create_document_base64",
        "method": "POST",
        "headers": {
          "Authorization": "Bearer {{connections.allsign.token}}",
          "Content-Type": "application/json"
        },
        "body": {
          "document_name": "{{trigger.body.document_name}}",
          "file_base64": "{{convert_file.base64}}",
          "file_name": "{{trigger.body.file_name}}"
        }
      }
    },
    {
      "name": "send_invitations",
      "displayName": "Enviar Invitaciones",
      "type": "HTTP",
      "settings": {
        "url": "https://api.enterprise.allsign.io/api/documents/{{create_document.body.document_id}}/send-bulk-invites",
        "method": "POST",
        "headers": {
          "Authorization": "Bearer {{connections.allsign.token}}",
          "Content-Type": "application/json"
        },
        "body": {
          "signers": "{{trigger.body.signers}}",
          "email_subject": "{{trigger.body.email_subject}}",
          "send_immediately": true
        }
      }
    }
  ]
}

Integraciones populares

CRM Integration (Salesforce)

Flujo: Oportunidad cerrada → Crear contrato → Enviar para firma

{
  "displayName": "Salesforce → AllSign",
  "trigger": {
    "type": "SALESFORCE_OPPORTUNITY_UPDATED",
    "settings": {
      "stage": "Closed Won"
    }
  },
  "actions": [
    {
      "name": "generate_contract",
      "displayName": "Generar Contrato",
      "type": "CODE",
      "settings": {
        "sourceCode": "// Lógica para generar PDF del contrato"
      }
    },
    {
      "name": "create_allsign_document",
      "displayName": "Crear en AllSign",
      "type": "HTTP",
      "settings": {
        "url": "https://api.enterprise.allsign.io/v1/documents/create_document_base64",
        "method": "POST"
      }
    }
  ]
}

Automatización de RRHH

Flujo: Nueva contratación → Generar documentos → Enviar paquete completo

E-commerce Integration

Flujo: Pedido completado → Generar términos → Solicitar firma

Configuración de Webhooks

Recibir notificaciones de AllSign

Crear webhook en Activepieces:
- Tipo: Webhook Trigger
- Método: POST
- Configurar validación
Registrar webhook en AllSign:

curl -X POST "https://api.enterprise.allsign.io/v1/webhooks" \
  -H "Authorization: Bearer TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-activepieces.com/api/v1/webhooks/allsign",
    "events": ["document.signed", "document.completed"],
    "active": true
  }'

Casos de uso empresariales

1. Onboarding automatizado

Trigger: Nuevo empleado en HRIS
Proceso: Generar contratos, políticas, NDAs
Resultado: Paquete completo enviado automáticamente

2. Ventas B2B

Trigger: Propuesta aceptada en CRM
Proceso: Crear contrato personalizado
Resultado: Envío automático y seguimiento

3. Compliance automatizado

Trigger: Vencimiento de documentos
Proceso: Generar renovaciones
Resultado: Notificación y nueva firma

Mejores prácticas

Manejo de errores

{
  "name": "error_handler",
  "type": "CODE",
  "settings": {
    "sourceCode": "export const code = async (inputs) => {\n  try {\n    // Lógica principal\n  } catch (error) {\n    // Enviar notificación de error\n    // Log del error\n    // Reintentar si es necesario\n  }\n};"
  }
}