> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectvets.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisa de satisfação

> Disparar pesquisa de satisfação a partir de qualquer ERP

# Disparar pesquisa de satisfação

Endpoint genérico para qualquer ERP (preferível a webhooks específicos de parceiro em novas integrações). Exige scope `satisfaction:write` e pesquisa habilitada no CRM.

## Pré-requisitos

1. Configuração de pesquisa habilitada no CRM, com etapa de pesquisa definida.
2. Contato já sincronizado (use [`PUT` de contatos](/flow/api-reference/contacts) antes, se preciso).
3. Contato com lead ativo (não finalizado) e chat WhatsApp associado.

## `POST …/satisfaction-surveys`

Identifique o contato com `external_id`, `document` ou `phone` (mesma ordem da API de contatos). O campo `reason` é opcional (padrão: `visit_completed_external`).

```http theme={null}
POST https://api.connectvets.com.br/flow/v1/external/workspaces/{workspace_id}/satisfaction-surveys
Authorization: Bearer flow_live_<secret>
Content-Type: application/json

{
  "external_id": "erp-cust-8821",
  "reason": "visit_completed"
}
```

### Resposta 200

```json theme={null}
{
  "triggered": true,
  "lead_id": "uuid",
  "contact_id": "uuid",
  "reason": "visit_completed"
}
```

| Campo / caso       | Significado                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------- |
| `triggered: true`  | Pesquisa enviada / lead movido para a etapa de pesquisa                                        |
| `triggered: false` | Config desabilitada, pesquisa já enviada ou condições não atendidas (**ainda assim HTTP 200**) |
| 400                | Identificador ausente / body inválido                                                          |
| 403                | Scope / workspace / billing                                                                    |
| 404                | Contato ou lead ativo não encontrado                                                           |

### cURL

```bash theme={null}
export FLOW_BASE_URL="https://api.connectvets.com.br/flow/v1"
export TOKEN="flow_live_<cole_aqui>"
export WORKSPACE_ID="$(curl -sS "$FLOW_BASE_URL/external/me" -H "Authorization: Bearer $TOKEN" | jq -r .workspace_id)"

curl -sS -X POST "$FLOW_BASE_URL/external/workspaces/$WORKSPACE_ID/satisfaction-surveys" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"erp-cust-8821","reason":"visit_completed"}'
```