Atualizar oportunidade no Salesflare, por uma API
Atualiza os campos informados de uma oportunidade. Movê-la pelo pipeline é uma mudança de etapa.
- Identificador
- salesflare_update_opportunity
A chamada
POST https://connect.reportei.com/api/tools/salesflare_update_opportunity/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": 1
}
}Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.
Parâmetros
As descrições dos parâmetros seguem a documentação oficial do app, em inglês.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | integer | Sim | Id of the opportunity, from List opportunities or Create opportunity. |
| name | string | Não | Name of the opportunity. |
| account | integer | Não | Id of the account, from List accounts. |
| stage | integer | Não | Id of the new stage, from the stages of List pipelines. |
| value | number | Não | Value of the deal, in the currency of the pipeline. |
| probability | number | Não | Chance of winning, in percent. |
| close_date | string | Não | Close date, in ISO 8601. |
| closed | boolean | Não | Whether the opportunity is closed. |
| done | boolean | Não | Whether the opportunity is marked as done. |
| main_contact | integer | Não | Id of the main contact, from List contacts. |
| owner | integer | Não | Id of the user who owns the opportunity, from List users. |
| assignee | integer | Não | Id of the user assigned to the opportunity, from List users. |
| tags | array | Não | Tag names. |
| custom | object | Não | Custom field values, keyed by the API name of each custom field of the team. |
Conexões possíveis
O seu cliente conecta a conta do Salesflare uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
A resposta
Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.
Pronta para agentes de IA
O input desta tool é um JSON Schema, disponível em GET /api/tools/salesflare_update_opportunity. Ele vira a definição de tool do seu agente sem conversão.
Outras tools do Salesflare
- Listar contasGETLista as contas, as empresas do time, 10 por página por padrão. Pagine com limit e offset; uma página menor que limit é a última.
- Obter contaGETRetorna uma conta com endereços, emails, telefones, tags e campos personalizados.
- Criar contaPOSTCria uma conta, a empresa à qual contatos e oportunidades pertencem. Retorna a nova conta com seu id.
- Atualizar contaPUTAtualiza os campos informados de uma conta.
- Listar contatosGETLista os contatos do time, 20 por página por padrão. Pagine com limit e offset; uma página menor que limit é a última.
- Obter contatoGETRetorna um contato com sua conta, cargos, telefones, endereços, tags e campos personalizados.
- Criar contatoPOSTCria um contato, vinculado a uma conta com account. Retorna o novo contato com seu id.
- Atualizar contatoPUTAtualiza os campos informados de um contato. archived true o arquiva.
Toolkits da mesma categoria
Ver os 100 toolkitsVeja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
