Contacts

Módulo de Gestão de Contatos

Listagem de contatos

get

Retorna uma lista de contatos para um dado componente.

Autorizações
Parâmetros de rota
component_idstring · uuidObrigatório

ID do componente

Parâmetros de consulta
pageinteger · intOpcional

número da página

limitinteger · intOpcional

número máximo de items na página (máx. 100)

Respostas
200

Sucesso

application/json
get
GET /contact/api/v1/{component_id}/contacts HTTP/1.1
Host: app.bolten.io
Authorization: Bearer API_KEY
Accept: */*

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-09-02T22:46:31.378Z",
      "updated_at": "2025-09-02T22:46:31.378Z",
      "created_by": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "John Smith",
        "email": "john@smith.com"
      },
      "attributes": {
        "Nome": "John Doe",
        "Email": "john@doe.com",
        "Telefone": "5511999999999"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1
  }
}

Criação de contato

post

Cria um contato em um componente.

Autorizações
Parâmetros de rota
component_idstring · uuidObrigatório

ID do componente

Corpo
attributesobjectObrigatório

Pares Chave/Valor no formato [Nome do atributo]: [Valor do atributo]

Respostas
201

Sucesso

application/json
post
POST /contact/api/v1/{component_id}/contacts HTTP/1.1
Host: app.bolten.io
Authorization: Bearer API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "attributes": {
    "Nome": "John Doe",
    "Email": "john@doe.com",
    "Telefone": "5511999999999"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-09-02T22:46:31.378Z",
  "updated_at": "2025-09-02T22:46:31.378Z",
  "created_by": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "John Smith",
    "email": "john@smith.com"
  },
  "attributes": {
    "Nome": "John Doe",
    "Email": "john@doe.com",
    "Telefone": "5511999999999"
  }
}

Dados do contato

get

Retorna os dados de um contato de um componente.

Autorizações
Parâmetros de rota
component_idstring · uuidObrigatório

ID do componente

contact_idstring · uuidObrigatório

ID do contato

Respostas
200

Sucesso

application/json
get
GET /contact/api/v1/{component_id}/contacts/{contact_id} HTTP/1.1
Host: app.bolten.io
Authorization: Bearer API_KEY
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-09-02T22:46:31.378Z",
  "updated_at": "2025-09-02T22:46:31.378Z",
  "created_by": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "John Smith",
    "email": "john@smith.com"
  },
  "attributes": {
    "Nome": "John Doe",
    "Email": "john@doe.com",
    "Telefone": "5511999999999"
  }
}

Atualização de contato

patch

Atualiza os dados de um contato de um componente. Afeta somente atributos que estão no corpo da requisição.

Autorizações
Parâmetros de rota
component_idstring · uuidObrigatório

ID do componente

contact_idstring · uuidObrigatório

ID do contato

Corpo
attributesobjectObrigatório

Pares Chave/Valor no formato [Nome do atributo]: [Valor do atributo]

Respostas
201

Sucesso

application/json
patch
PATCH /contact/api/v1/{component_id}/contacts/{contact_id} HTTP/1.1
Host: app.bolten.io
Authorization: Bearer API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "attributes": {
    "Email": "john@doe.com"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-09-02T22:46:31.378Z",
  "updated_at": "2025-09-02T22:46:31.378Z",
  "created_by": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "John Smith",
    "email": "john@smith.com"
  },
  "attributes": {
    "Nome": "John Doe",
    "Email": "john@doe.com",
    "Telefone": "5511999999999"
  }
}

Estrutura dos contatos

get

Retorna a estrutura dinâmica dos contatos do componente.

Autorizações
Parâmetros de rota
component_idstring · uuidObrigatório

ID do componente

Respostas
200

Sucesso

application/json
get
GET /contact/api/v1/{component_id}/schema HTTP/1.1
Host: app.bolten.io
Authorization: Bearer API_KEY
Accept: */*

{
  "attributes": [
    {
      "id": "3763e13a-0273-401c-9c16-b7afa9aef134",
      "name": "Nome",
      "content_type": "string",
      "visibility": "show"
    },
    {
      "id": "c8f474d1-fbce-4270-98cb-aa5ea6cc3551",
      "name": "Email",
      "content_type": "email",
      "visibility": "show",
      "example_value": "email@exemplo.com.br"
    },
    {
      "id": "88e1ffd1-16d2-4d41-8c7c-8d5fbd001aad",
      "name": "Telefone",
      "content_type": "phone1",
      "visibility": "show",
      "example_value": "(11) 99999-9999"
    }
  ]
}
AnteriorOpportunitiesPróximoMeta Ads