---
title: "Busca pessoas para vincular a uma conversa"
method: GET
path: "/pessoas/buscar"
tags: ["Pessoas"]
---

# Busca pessoas para vincular a uma conversa

`GET /pessoas/buscar`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/comunicador`
- URL: `https://integracao.cvcrm.com.br/api/v1/comunicador/pessoas/buscar`
- Auth: HTTP bearer

Lista pessoas candidatas a receber o contato de uma conversa ainda sem cliente
identificado, para o operador escolher qual delas é o interlocutor.

Termos com menos de 3 caracteres não consultam a base e retornam lista vazia. O
retorno é limitado a 10 pessoas, ordenadas por nome.

## Query parameters

- `termo` string, required

## Response `200`

Pessoas candidatas ao vínculo

- object
  - `status` string
  - `data` object[]
    - `idpessoa` integer
    - `nome` string, nullable
    - `documento` string, nullable: CPF ou CNPJ da pessoa, no formato gravado no cadastro

## Other responses

- `400`: Termo não informado
- `401`: Token ausente ou inválido

---

[API](https://skmtc.dev/cvcrm/apis/comunicador.md) - [All operations](https://skmtc.dev/cvcrm/apis/comunicador/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/comunicador/revisions/83f3c9ab22fa?raw)