Documentation Index Fetch the complete documentation index at: https://developers.matchsales.com.br/llms.txt Use this file to discover all available pages before exploring further.
Pula uma tarefa de cadência. Altera apenas o estado da tarefa, sem envio ao canal.
Exemplos
A URL usa o servidor de produção. Defina PIPEFACIL_API_KEY e as variáveis de caminho (como SEQ ou ID) com os identificadores reais. Ajuste o corpo antes de executar: requisições de escrita alteram dados do workspace.
cURL
curl --request POST \ --url "https://pipefacil-server.matchsales.com.br/api/v1/deals/$SEQ/cadence/tasks/$TASKID/skip" \ --header "Authorization: Bearer $PIPEFACIL_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "reason": "Atividade tratada por outro canal"}'
JavaScript
const response = await fetch(`https://pipefacil-server.matchsales.com.br/api/v1/deals/${process.env.SEQ}/cadence/tasks/${process.env.TASKID}/skip`, { method: "POST", headers: { Authorization: `Bearer ${process.env.PIPEFACIL_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "reason": "Atividade tratada por outro canal"}),});if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);const text = await response.text();const data = text ? JSON.parse(text) : null;
Python
import osimport jsonimport requestsresponse = requests.request( "POST", f"https://pipefacil-server.matchsales.com.br/api/v1/deals/{os.environ['SEQ']}/cadence/tasks/{os.environ['TASKID']}/skip", headers={"Authorization": f"Bearer {os.environ['PIPEFACIL_API_KEY']}"}, json=json.loads("{\n \"reason\": \"Atividade tratada por outro canal\"\n}"),)response.raise_for_status()data = response.json() if response.content else None
Parâmetros
Nome
Local
Tipo
Obrigatório
Descrição
seq
path
integer
Sim
—
taskId
path
string
Sim
Identificador da tarefa de cadência.
Corpo da requisição
Content-Type: application/json · obrigatório
{ "reason": "Atividade tratada por outro canal"}
Campo
Tipo
Obrigatório no objeto
Descrição
reason
string
Sim
Motivo para pular a tarefa. Até 255 caracteres.
Esquema OpenAPI
{ "type": "object", "required": [ "reason" ], "properties": { "reason": { "type": "string", "maxLength": 255, "description": "Motivo para pular a tarefa." } }, "example": { "reason": "Atividade tratada por outro canal" }}
Respostas
204Sem conteúdo400Falha de validação dos campos; `fieldErrors` contém os erros.
403Autenticado, mas sem acesso: falta de permissão (`FORBIDDEN`), recurso desligado no workspace (`FEATURE_DISABLED`) ou tentativa de acessar uma agenda não permitida.
409Conflito de estado, como um negócio aberto duplicado para o contato/funil, ou limite do plano atingido (`QUOTA_EXCEEDED`), como na criação de um funil além da cota.
