Pular para o conteúdo principal
English (United States) Español (Latinoamérica)

Como funciona a acción de Workflow: Enviar HTTP Request?

Atualizado

O que é a ação Enviar HTTP Request?

Enviar HTTP Request é uma ação dos modelos do Workflow que permite que Buk se comunique automaticamente com sistemas externos (por exemplo, outros softwares ou plataformas internas) sempre que uma solicitação desse modelo for disparada, podendo ser de forma manual ou automática conforme você configurar.

Em resumo: quando uma automação ou uma solicitação é executada (por exemplo, uma alta, baixa ou movimentação de trabalho), o Buk pode enviar informações básicas do colaborador e da empresa para outro sistema para avisar que essa mudança ocorreu.
Isso permite, por exemplo, atualizar sistemas internos, sincronizar dados de pessoas, acionar processos em ferramentas de TI ou RH, registrar eventos em sistemas externos ou manter diferentes plataformas integradas, sem que ninguém precise fazer isso manualmente.

Essa ação foi pensada para integrações técnicas. Sua configuração deve ser feita junto à equipe de TI ou à área especialista da sua organização, responsável pelo sistema externo e pela sua segurança.
O Buk não configura nem valida sistemas externos, já que estes dependem da infraestrutura, regras e definições de cada empresa.

Essa ação está disponível apenas em modelos do tipoFlexible, tanto em automatizações como em modelos manuais.

O que você precisa antes?

Ter Workflow e API habilitados (Exclusivos do plan Plataforma Pro)
Ter a permissãoWorkflow > Modelos e Solicitações em Modificación
Ter permissão deAPI > Acessos API > Webhooksem Sim
Ter o endpoint externo para o qual você deseja enviar a informação e saber qual método, autenticação e formato ele requer.

Como configurar a ação Enviar HTTP Request?

Dentro da etapa final do seu modelo flexível:

1. Selecione a ação

Clique emAdicionar açãoe escolhaEnviar Request HTTP.

Um modal aparecerá com os campos necessários para configurar a request.

2. Configure o método e a URL

Método HTTP:selecione o método que seu sistema externo necessitar:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

URL:escreva o endereço do endpoint externo para o qual enviaremos a request. Exemplo de formato: https://tudominio.cl

Essa request será enviada automaticamente sempre que o evento da automação for acionado.

 

3. Defina o tipo de autenticação (opcional de acordo com sua API)

Na abaAuth, escolha como sua request será autenticada:

  • Sem autenticação

  • Basic Auth(usuário + senha)

  • Bearer Token

  • API Key(incluída no header ou em parâmetros da URL, conforme o que sua API externa exigir)

Preencha os campos conforme solicitado pelo serviço externo.

 

4. Construa o Body (conteúdo da mensagem)

Na abaBodyvocê pode definir o conteúdo que Buk enviará na request.

  • URL do tenant

  • Data

  • Tipo de evento

  • Estado de emprego

  • ID do colaborador

  • Nome completo

  • Email corporativo

  • RUT / DNI / RFC / CPF conforme o país

  • Nome da empresa

  • ID da área

  • Cargo

  • ID do workflow

Esses valores serão preenchidos automaticamente conforme o colaborador e a solicitação que disparou a automação.

Por enquanto, não é possível escrever texto livre nem adicionar campos personalizados: o conjunto de campos está definido.

Body JSON:

Los campos disponibles en el Body son:

- **tenant_url**: URL del tenant  
- **date**: Fecha  
- **event_type**: Tipo de evento  
- **employment_status**: Estado de empleo  

- **employee** (datos del colaborador):  
  - **employee_id**: ID del colaborador  
  - **full_name**: Nombre completo  
  - **email_corporate**: Email corporativo  
  - **rut** (u otro identificador según país)  

- **organization** (datos de la organización):  
  - **company_name**: Nombre de la empresa  
  - **area_id**: ID del área  
  - **job_role**: Cargo  

- **metadata**:  
  - **workflow_id**: ID del workflow

Un ejemplo de body JSON es:

```json
{
  "tenant_url": "chile",
  "date": "2025-12-11T13:28:51-03:00",
  "event_type": "workflow_action",
  "employment_status": "activo",
  "employee": {
    "employee_id": 2758,
    "full_name": "Rodrigo Contreras",
    "email_corporate": "rodrigo@correo.cl",
    "rut": "20.202.020-2"
  },
  "organization": {
    "company_name": "LRE MEDIPASS-INTEGRAMDEDICA",
    "area_id": 200,
    "job_role": "Product Owner"
  },
  "metadata": {
    "workflow_id": 2292
  }
}

 

O que acontece quando a automação é executada?

Cada vez que o evento configurado ocorrer, o Buk enviará automaticamente a request com:

  • O método selecionado

  • A URL definida

  • A autenticação escolhida

  • Os valores do body preenchidos com as informações do colaborador, da organização e do workflow

Se a request falhar (por exemplo, por um endpoint fora do ar ou um erro de autenticação), a solicitação flexível mostrará o estadoErrona sua execução, indicando que a ação externa não pôde ser concluída.

Boas práticas

  • Verifique que a API externa aceite o método selecionado.

  • Certifique-se de que sua API externa possa trabalhar com o formato de dados que o Buk envia

  • Teste seu endpoint com ferramentas externas antes de configurá-lo no Buk.

  • Mantenha seus tokens ou credenciais atualizados para evitar erros de autenticação.

 

🤖 Este artigo foi traduzido com inteligência artificial. Ver artigo original.

Artigos relacionados