Comentar na oportunidade
POST
/pipelines/{pipeline_id}/opportunities/{opportunity_id}/commentsEscreve um comentário na oportunidade, como o Adicionar Comentário do cartão. Serve para registrar no pipeline o que aconteceu no seu sistema, como uma proposta enviada ou um pagamento.
Requisição
curl -X POST "https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/comments" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Proposta enviada por e-mail: Plano Pro anual com 10% de desconto."
}'
const resposta = await fetch('https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/comments', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
content: 'Proposta enviada por e-mail: Plano Pro anual com 10% de desconto.',
}),
});
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/comments",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
json={
"content": "Proposta enviada por e-mail: Plano Pro anual com 10% de desconto.",
},
timeout=30,
)
print(resposta.status_code, resposta.json())
<?php
$ch = curl_init('https://app.nextagsai.com.br/api/pipelines/4001/opportunities/4201/comments');
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([
'content' => 'Proposta enviada por e-mail: Plano Pro anual com 10% de desconto.',
]),
]);
$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 (veja Listar pipelines).
opportunity_idintegerobrigatórioO ID da oportunidade (veja Listar oportunidades).
Corpo da requisição
JSONContent-Type: application/json
contentstringobrigatórioO texto do comentário.
Respostas
200Sucesso
O comentário criado.
idintegerO ID do comentário.
datastringO texto do comentário.
created_atstringQuando o comentário foi escrito, em UTC.
Exemplo: 2026-10-21 13:15:00
created_byintegerO ID do administrador que escreveu.
401Chave inválida
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Contatos, fluxos e outros identificadores
Guia que usa este endpointCriar e mover oportunidades no pipeline
Guia que usa este endpointComentários, anexos e campos do pipeline
Tutorial da Central de AjudaListar pipelines
GET /pipelinesConsultar pipeline
GET /pipelines/{pipeline_id}Listar etapas do pipeline
GET /pipelines/{pipeline_id}/stagesEste conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.