Inserir registro de CRM

POST /insert_crm

Cria um registro de relacionamento no CRM da unidade informada. O endpoint aceita um corpo JSON e retorna o token do registro criado.

URL completa: https://portal.fipli.pro/api/v1/insert_crm

Autenticação

Envie access_token e unit_token no corpo da requisição. Os dois campos são obrigatórios.

Body da requisição

Campo	Tipo	Obrigatório	Descrição
access_token	string	Sim	Token de acesso da API.
unit_token	string	Sim	Token da unidade que receberá o registro.
id_contact	string	Não	Token do contato relacionado. Se enviado, o contato deve estar ativo e pertencer à unidade informada.
record_date	string	Não	Data do registro no formato YYYY-MM-DD. Se omitida, é usada a data atual.
communication_type	string	Não	Tipo de comunicação registrada.
lifecycle_phase	string	Não	Fase do ciclo de vida do contato.
lead_status	string	Não	Situação do lead.
description	string	Não	Descrição ou observação do registro.
contact_success	boolean	Não	Informa se o contato foi bem-sucedido. O padrão é false.
next_contact_datetime	string	Não	Data e hora previstas para o próximo contato. Envie em formato de data e hora aceito pelo PostgreSQL, de preferência ISO 8601.
next_contact_reason	string	Não	Motivo ou objetivo do próximo contato.

Exemplo de requisição

curl -X POST 'https://portal.fipli.pro/api/v1/insert_crm' \
  -H 'Content-Type: application/json' \
  -d '{
    "access_token": "<access_token>",
    "unit_token": "<unit_token>",
    "id_contact": "<id_contact>",
    "record_date": "2026-08-24",
    "communication_type": "WhatsApp",
    "lifecycle_phase": "Negociação",
    "lead_status": "Em andamento",
    "description": "Cliente solicitou uma nova proposta.",
    "contact_success": true,
    "next_contact_datetime": "2026-08-27T14:00:00-03:00",
    "next_contact_reason": "Apresentar a proposta revisada"
  }'

Respostas

Sucesso — 200 OK

{
  "success": true,
  "message": "CRM record inserted successfully",
  "token": "<token_do_registro>"
}

Erros

Status	Mensagem	Quando ocorre
400	Missing required parameters.	access_token ou unit_token não foi enviado.
403	Invalid access_token or unit_token	Os tokens de acesso ou de unidade são inválidos.
403	id_contact not found, inactive, or not linked to unit_token	O contato informado não existe, está inativo ou não pertence à unidade.
500	An unexpected error occurred. Please try again later.	Ocorreu uma falha interna ao gravar o registro.

Observações

• Campos de texto vazios são gravados como null.
• O registro é criado como ativo.
• Esta página documenta somente a API pública versionada em /api/v1. As rotinas internas do CRM utilizadas pelo portal não fazem parte deste contrato de integração.