Listar e buscar contatos

GET /contatos

curl "https://chat.forsi.com.br/api/v1/contatos?telefone=31988887777" \
  -H "Authorization: Bearer $FORSI_CHAVE"

const resposta = await fetch('https://chat.forsi.com.br/api/v1/contatos?telefone=31988887777', {
  headers: {
    Authorization: `Bearer ${process.env.FORSI_CHAVE}`,
  },
});
const json = await resposta.json();
if (!resposta.ok) throw new Error(`${resposta.status} ${json.erro.codigo}: ${json.erro.mensagem}`);
console.log(json.dados);

import os
import requests

resposta = requests.get(
    "https://chat.forsi.com.br/api/v1/contatos",
    headers={
        "Authorization": f"Bearer {os.environ['FORSI_CHAVE']}",
    },
    params={
        "telefone": "31988887777",
    },
    timeout=30,
)
corpo = resposta.json()
if not resposta.ok:
    raise RuntimeError(f"{resposta.status_code} {corpo['erro']['codigo']}: {corpo['erro']['mensagem']}")
print(corpo["dados"])

{
  "dados": [
    {
      "id": "08054a7f-a752-481e-9915-cf4cf944df39",
      "nome": "Maria Souza",
      "nome_whatsapp": "Maria",
      "telefone": "+5531988887777",
      "email": "maria@exemplo.com.br",
      "instagram": "maria.souza",
      "campos": {"convenio":"Unimed"},
      "bloqueado": false,
      "criado_em": "2026-10-04T13:05:12.481Z",
      "atualizado_em": "2026-10-04T13:05:12.481Z",
      "primeiro_anuncio": {
        "anuncio_id": "texto",
        "titulo": "Consulta de retorno",
        "canal": "whatsapp",
        "clicado_em": "2026-10-04T13:05:12.481Z"
      }
    }
  ],
  "proximo": "1791205512481_3791c08d-72dd-4002-89ff-1e14a11c07e5"
}