Transferir oportunidade de pipeline
/pipelines/{pipeline_id}/opportunities/{opportunity_id}/transfer-to-pipelineLeva a oportunidade para outro pipeline, numa etapa escolhida, como o Transferir para o Pipeline do cartão. A etapa é do pipeline de destino: pegue o ID dela em Listar etapas do pipeline, com o ID do pipeline novo. Veja Oportunidades e tickets.
curl -X POST "https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/transfer-to-pipeline" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_pipeline_id": 4002,
"target_stage_id": 4111
}'
const resposta = await fetch('https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/transfer-to-pipeline', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
target_pipeline_id: 4002,
target_stage_id: 4111,
}),
});
const dados = await resposta.json();
console.log(resposta.status, dados);
import os
import requests
resposta = requests.post(
"https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/transfer-to-pipeline",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
json={
"target_pipeline_id": 4002,
"target_stage_id": 4111,
},
timeout=30,
)
print(resposta.status_code, resposta.json())
<?php
$ch = curl_init('https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/transfer-to-pipeline');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'target_pipeline_id' => 4002,
'target_stage_id' => 4111,
]),
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);
Autenticação
Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.
Parâmetros de caminho
pipeline_idintegerobrigatórioO ID do pipeline onde a oportunidade está agora.
opportunity_idintegerobrigatórioO ID da oportunidade (veja Listar oportunidades).
Corpo da requisição
JSONContent-Type: application/json
target_pipeline_idintegerobrigatórioO ID do pipeline de destino.
target_stage_idintegerobrigatórioO ID da etapa do pipeline de destino onde a oportunidade entra.
Respostas
A oportunidade mudou de pipeline.
successbooleantrue quando deu certo.
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Criar e mover oportunidades no pipeline
Guia que usa este endpointOportunidades e tickets: criar, mover, ganhar e perder
Tutorial da Central de AjudaListar pipelines
GET /pipelinesConsultar pipeline
GET /pipelines/{pipeline_id}Listar etapas do pipeline
GET /pipelines/{pipeline_id}/stagesListar campos do pipeline
GET /pipelines/{pipeline_id}/custom_fieldsEste conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.