API para ações na equipe


📌API de Transferência de Carteira de Clientes


API: Todas

Transferir toda Carteira de Clientes de um membro da equipe para outro.

– “OLD_carteiraId”: ID do User da Equipe que irá transferir sua carteira

– “NEW_carteiraId”: ID do User da Equipe que recebe a transferência da carteira




Visão Geral

Esta API permite mover todos os contatos de uma carteira para outra dentro do sistema da GP Connect. Pode ser utilizada em reestruturações de times de atendimento, transferência de leads entre vendedores ou redefinição de segmentações.




📂 Estrutura do Código PHP


<?php


$curl = curl_init();


curl_setopt_array($curl, array(

  CURLOPT_URL => 'https://api.gpconnect.com.br/api/contacts/changecarteira',

  CURLOPT_RETURNTRANSFER => true,

  CURLOPT_ENCODING => '',

  CURLOPT_MAXREDIRS => 10,

  CURLOPT_TIMEOUT => 0,

  CURLOPT_FOLLOWLOCATION => true,

  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,

  CURLOPT_CUSTOMREQUEST => 'POST',

  CURLOPT_POSTFIELDS =>'{

    "OLD_carteiraId":40,

    "NEW_carteiraId":39

  }',

  CURLOPT_HTTPHEADER => array(

    'Content-Type: application/json',

    'Authorization: Bearer {seutokenaqui}' //Token cadastrado na conexão

  ),

));


$response = curl_exec($curl);


curl_close($curl);

echo $response;





📘 Detalhamento Técnico

1. Endpoint

  • https://api.gpconnect.com.br/api/contacts/changecarteira




2. Método HTTP

  • POST




3. Cabeçalhos (Headers)

Header

Valor

Content-Type

application/json

Authorization

Bearer {seutokenaqui}





{

  "OLD_carteiraId": 40,

  "NEW_carteiraId": 39

}


Descrição dos Campos

Campo

Tipo

Obrigatório

Descrição

OLD_carteiraId

int

Sim

ID da carteira de origem dos contatos

NEW_carteiraId

int

Sim

ID da nova carteira para onde os contatos irão








5. Exemplo de Resposta (JSON)

{

    "total": 1,

    "migrated": 0,

    "skipped": 1,

    "failed": 0,

    "errors": [ ]

}









Atualizado em 23/04/2025
Este artigo foi útil?  
Agradecemos sua avaliação.