agenciafmd/laravel-nectarcrm

Integração com o Nectar CRM

dev-master 2026-03-26 15:34 UTC

Requires

• laravel/framework: ^11.0

MIT

• João Paulo

README

• Integração com o Nectar CRM para projetos Laravel.

Instalação

composer require agenciafmd/laravel-nectarcrm:v11.x-dev

Configuração

Adicione as variáveis de ambiente ao seu arquivo .env:

NECTARCRM_ACCESS_TOKEN=seu-token-aqui
NECTARCRM_ERROR_EMAIL=[e-mail]

Obs: Gere ou solicite a geração do Access-Token em: Integrações > Gerar Token.

Caso queira customizar as configurações, publique o arquivo de configuração:

php artisan vendor:publish --tag=laravel-nectarcrm:config

Uso

Job de Conversão

O pacote fornece um Job para enviar conversões ao Nectar CRM de forma assíncrona.

use Agenciafmd\Nectarcrm\Jobs\SendConversionsToNectarcrm;

$paylod = [
    'nome' => $data['enterprise'],
    'razaoSocial' => $data['enterprise'],
    'origem' => 'Site - ' . config('app.url'),
    'categoria' => 'Cliente em potencial',
    'constante' => 3, // 0 = cliente, 1 = prospect, 2 = suspect, 3 = lead, 5 = descartados
    'sigiloso' => false,
    'ativo' => true,
    'emails' => [
        $data['email'], // required
    ],
    'telefones' => [
        $data['phone'], // [phone]
    ],
    'responsavel' => [
        'login' => $postal->to,
        'nome' => $postal->to_name,
    ],
    'camposPersonalizados' => [ // verificar a existencia dos campos no Nectar CRM
        'Nome da empresa' => $data['enterprise'],
        'Quantidade de colaboradores' => $data['employees'],
        'utm_campaign' => Cookie::get('utm_campaign', ''),
        'utm_content' => Cookie::get('utm_content', ''),
        'utm_medium' => Cookie::get('utm_medium', ''),
        'utm_source' => Cookie::get('utm_source', ''),
        'utm_term' => Cookie::get('utm_term', ''),
    ],
    'contatos' => [
        [
            'nome' => $data['name'],
            'cargo' => $data['role'],
            'emails' => [
                $data['email'],
            ],
        ],
    ],
];

dispatch(new SendConversionsToNectarcrm($paylod))
    ->delay(5)
    ->onQueue('low');

Obs: verifique os campos obrigatórios em Contatos > Organizar Campos.

Macro HTTP

Você também pode utilizar a macro Http::nectarcrm() para realizar outras requisições à API do Nectar CRM.

use Illuminate\Support\Facades\Http;

$response = Http::nectarcrm()->get('contatos/', [
    'email' => '[e-mail]',
]);

if ($response->successful()) {
    $contato = $response->json();
}

Licença

Licença MIT. Clique aqui para mais detalhes.