CRM Raddar Digital API

Registrar CRM

POST: https://crm.raddar.digital/crm/api/registrar-crm

Função

Registra um fluxo completo no CRM.
Este endpoint manipula os dados recebidos para registrar um contato e uma oportunidade.

Caso o contato já exista, seus dados não são alterados.

Caso uma oportunidade para este contato já exista, dependendo da configuração de cadastramento no CRM, uma anotação pode ser criada e a oportunidade reaberta, ou uma nova oportunidade é criada. Confira a aba "Configurações > Integração" no seu CRM para saber este comportamento.

Parâmetros

O campo form_name é obrigatório.

Campo Descrição
form_name Identificador do formulário associado a oportunidade.

Exemplo

{
    "token": "TOKEN_DA_EMPRESA",
    "data": {
        "form_name": "nome_do_formulario",
        "contato_id": ID_CONTATO,
        "responsavel_id": ID_RESPONSAVEL,
        "funil_id": ID_FUNIL,
        "fonte_id": ID_FONTE,
        "titulo_oportunidade": "Título da oportunidade",
        "avaliacao_oportunidade": 1,
        "origem_oportunidade": "Nome da origem",
        "valor_unico": "0,00",
        "valor_recorrente": "0,00",
        "nome": "Nome do contato",
        "email": "email@email.com",
        "telefone": "(12) 1234-1234",
        "celular": "(12) 1234-1234",
        "endereco": "Rua ABC",
        "cidade": "Goiânia",
        "estado": "GO",
        "cep": "740000-000",
        "campo_adicional_1": "...",
        "campo_adicional_2": "..."
        [ ... ]
    }
}

Retorno

Resposta HTTP

Código Situação
200 Sucesso Fluxo criado com sucesso ou formulário não capturado pelo CRM.
403 Não Autorizado Token da empresa faltando ou inválido.
500 Erro Erro ao criar alguma etapa do fluxo ou parâmetros obrigatórios faltando.

Dados

{
    "status": true,
    "mensagem": "Fluxo criado com sucesso."
}