CUBO CRM
  1. Annotation
CUBO CRM
  • Comece por aqui
  • Activities
    • Listar todas as atividades
      GET
    • Criar nova atividade
      POST
    • Obter atividade por ID
      GET
    • Atualizar atividade
      PUT
    • Excluir atividade
      DELETE
  • Annotation
    • Criar nova anotação
      POST
    • Obter anotação por ID
      GET
    • Atualizar anotação
      PUT
    • Excluir anotação
      DELETE
  • Apikey
    • Listar todas as apikeys
      GET
    • Criar nova apikey
      POST
    • Obter apikey por ID
      GET
    • Atualizar apikey
      PUT
    • Excluir apikey
      DELETE
  • Category
    • Listar todas as categorias
      GET
    • Criar nova categoria
      POST
    • Obter categoria por ID
      GET
    • Atualizar categoria
      PUT
    • Excluir categoria
      DELETE
  • Company
    • Obter empresa
      GET
    • Atualizar empresa
      PUT
  • Custom Field
    • Listar todos os campos personalizados
      GET
    • Criar novo campo personalizado
      POST
    • Obter campo personalizado por ID
      GET
    • Atualizar campo personalizado
      PUT
    • Excluir campo personalizado
      DELETE
  • Deal
    • Listar todos os negócios
    • Criar novo negócio
    • Obter negócio por ID
    • Atualizar negócio
    • Excluir negócio
  • Domain
    • Listar todos os domínios
    • Criar novo domínio
    • Obter domínio por ID
    • Excluir domínio
  • LostReason
    • Listar todos os motivos de perda
    • Criar motivo de perda
    • Obter motivo de perda por ID
    • Atualizar motivo de perda
    • Excluir motivo de perda
  • Organization
    • Listar todas as organizações
    • Criar nova organização
    • Obter organização por ID
    • Atualizar organização
    • Excluir organização
  • People
    • Listar todas as pessoas
    • Criar nova pessoa
    • Obter pessoa por ID
    • Atualizar pessoa
    • Excluir pessoa
  • Pipe
    • Listar todos os funis
    • Criar novo funil
    • Listar funil por ID
    • Atualizar Funil
    • Excluir funil
  • Product
    • Listar todos os produtos
    • Criar novo produto
    • Obter produto por ID
    • Atualizar produto
    • Excluir produto
  • Proposal
    • Listar todos as propostas
    • Criar proposta para negociação pelo ID
    • Obter proposta por ID
    • Atualizar proposta
  • Stage
    • Buscar todos os estágios do funil pelo ID
    • Criar estágios
    • Obter estágios por ID
    • Atualizar estágio
    • Excluir estágio
  • Template
    • Listar todos os templates de mensagem
    • Criar template de mensagem
    • Criar template de mensagem para negócio pelo ID
    • Obter template de mensagem por ID
    • Atualizar template de mensagem
    • Excluir template de mensagem
  • Webhooks
    • Receber dados do BotConversa para criação
    • Receber dados do BotConversa para atualização
    • Receber dados do ManyChat para criação
    • Receber dados do ManyChat para atualização
  1. Annotation

Criar nova anotação

POST
https://api.cubosuite.com.br/annotations
Descrição#
Cria uma nova anotação (annotation), vinculada a um negócio (deal), organização, pessoa ou atividade.
O autor da anotação será sempre o usuário autenticado.
Se arquivos temporários forem enviados, eles serão movidos para o destino final.
Se vinculada a um negócio (deal), o campo rotten será automaticamente desativado.
Campos obrigatórios#
CampoTipoDescrição
textstringTexto da anotação. Campo obrigatório.
dealIdnumber (opcional)ID do negócio vinculado. Necessário caso organizationId, peopleId e activityId não sejam informados.
organizationIdnumber (opcional)ID da organização vinculada. Necessário caso os demais não sejam informados.
peopleIdnumber (opcional)ID da pessoa vinculada. Necessário caso os demais não sejam informados.
activityIdnumber (opcional)ID da atividade vinculada. Necessário caso os demais não sejam informados.
typeenumTipo da anotação. Valores possíveis: observation, activity, files, alteration, whatsapp. Obrigatório.
urlFilesarray de strings (opcional)Lista de URLs dos arquivos associados. Arquivos temporários serão movidos.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cubosuite.com.br/annotations' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "Reunião realizada com o cliente. Análise positiva.",
  "dealId": 12,
  "type": "activity",
  "urlFiles": [
    "https://meuarquivo.com/tmp/123.png",
    "https://meuarquivo.com/final/456.jpg"
  ]
}'
Response Response Example
200 - Success
{
    "id": 90,
    "text": "Primeira anotação no negócio",
    "type": "observation",
    "dealId": 1070,
    "userId": 36,
    "createdAt": "2021-06-30T20:20:27.000-03:00",
    "updatedAt": null,
    "deal": {
        "id": 1070,
        "title": "Prospecção"
    },
    "user": {
        "id": 36,
        "name": "Rayssa Assis"
    }
}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header
Content-Type
string 
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
text
string 
requerido
organizationId
integer 
requerido
type
string 
requerido
Examples

Respostas

🟢200Success
application/json
Body
id
integer 
requerido
text
string 
requerido
type
string 
requerido
dealId
integer 
requerido
userId
integer 
requerido
createdAt
string 
requerido
updatedAt
null 
requerido
deal
object 
requerido
id
integer 
requerido
title
string 
requerido
user
object 
requerido
id
integer 
requerido
name
string 
requerido
🟠400Pedido inválido
🟠401Não autorizado
Página anterior
Annotation
Próxima página
Obter anotação por ID
Built with