Cfaz Webhook - Pedidos

Criada por Alexandre Pateis, Modificado em Sex, 19 Dez, 2025 na (o) 9:34 AM por Alexandre Pateis

A Cfaz envia automaticamente os dados completos do Pedido para a URL configurada, para isso basta selecionar o Tipo de Cadastro na configuração do webhook como Pedido.

A configuração pode ser realizada em:

Configurações → Integração → Webhook

Informações enviadas

chave: O Token informado na configuração.
event: Tipo do evento que gerou o gatilho de envio do webhook, podendo assumir os seguintes valores:
- create: Criação
- update: Atualização
- delete: Exclusão
id: O ID do pedido.
patient_datum: Dados do paciente informado no pedido.
dentist_datum: Dados do solicitante informado no pedido.
clinic: Dados da clínica que criou o pedido.

Estrutura do payload

Exemplo de requisição enviada pelo Cfaz ao webhook do cliente:

{
  "chave": "4dbrj4mrumm4me9beh223r",
  "data": {
    "archives": [],
    "carpals": [],
    "clinic": {
      "id": 911,
      "name": "Clínica de Exemplo"
    },
    "clinic_id": 911,
    "created_at": "2025-12-19T09:24:55.000-03:00",
    "date": "2025-12-19T09:21:00.000-03:00",
    "dental_models": [],
    "dentist_datum": {
      "birthdate": "1980-01-01",
      "cbo": "999999",
      "clinic_id": 911,
      "commercial_phone": "",
      "cpf": null,
      "cro": null,
      "email": "solicitante@solicitante.com",
      "home_phone": "",
      "id": 75373,
      "mobile_phone": "",
      "name": "Solicitante Exemplo"
    },
    "dentist_datum_id": 75373,
    "digital_models": [],
    "external_access": "https://max.cfaz.net/requests/307471",
    "frontal_facials": [
      {
        "download_url": "",
        "id": 3716,
        "link": "https://max.cfaz.net/traceable/FrontalFacial/3716/edit",
        "model_name": "FrontalFacial",
        "owner_name": null
      }
    ],
    "frontals": [],
    "id": 307471,
    "images_download_links": [],
    "implants": [],
    "lateral_facials": [],
    "link": "https://max.cfaz.net/requests/307471",
    "link_token": "http://localhost:3000/requests_with_token/307471?access_token=e202444c32e7f81ddb0c291bdc84294f5d9a5ff9",
    "patient_datum": {
      "birthdate": "2000-01-01",
      "clinic_id": 911,
      "comment": "",
      "commercial_phone": "+55 49 99999 9999",
      "cpf": "00000000000",
      "created_by_user_id": 41,
      "custom_field_1": "",
      "custom_field_2": "",
      "custom_field_3": null,
      "custom_field_4": null,
      "custom_field_5": null,
      "custom_password": "MRA63S9H",
      "email": "paciente@paciente.com",
      "externally_imported": false,
      "father_name": "",
      "father_occupation": "",
      "gender": true,
      "home_phone": "+55 49 99999 9999",
      "id": 476021,
      "last_request_date": "2025-12-19T09:21:00.000-03:00",
      "mobile_phone": "+55 49 99999 9999",
      "mother_name": "",
      "mother_occupation": "",
      "name": "Paciente Exemplo",
      "occupation": "",
      "own_cpf": true,
      "responsible_cpf": "",
      "rg_id": "",
      "species": null,
      "spouse_name": "",
      "spouse_phone": "",
      "weight": null
    },
    "patient_datum_id": 476021,
    "reports": [
      {
        "associated_images_download_links": [],
        "id": 166265,
        "link": "https://max.cfaz.net/reports/166265/edit",
        "owner_name": null,
        "text": null
      }
    ],
    "request_status_id": 52,
    "sequential_id": 1601,
    "teleradiographies": [],
    "tomographies": [],
    "updated_at": "2025-12-19T09:24:55.000-03:00"
  },
  "event": "create",
  "timestamp": "2025-12-19T09:24:56-03:00"
}

Validar requisição enviada pelo Cfaz

Para realizar a validação dos dados enviados pelo Cfaz pelo WebHook, leia a documentação:

Validação da Requisição Webhook