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

Configuração de pesquisa habilitada no CRM, com etapa de pesquisa definida.
Contato já sincronizado (use PUT de contatos antes, se preciso).
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).

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

{
  "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

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"}'

Começar

Workspaces

Contatos

Pesquisa de satisfação

Eventos

Inteligência artificial

Referência

Pesquisa de satisfação

Disparar pesquisa de satisfação

Pré-requisitos

`POST …/satisfaction-surveys`

Resposta 200

cURL

​Disparar pesquisa de satisfação

​Pré-requisitos

​POST …/satisfaction-surveys

​Resposta 200

​cURL

Disparar pesquisa de satisfação

Pré-requisitos

`POST …/satisfaction-surveys`

Resposta 200

cURL