Digitalk Developers
  1. Assinaturas
Raiz
  • Raiz
  • CRM
    • CRM — Overview
    • Genérico (data)
      • CRM - Genérico
      • Listar/filtrar registros (qualquer tabela do CRM)
      • Criar/atualizar registros (qualquer tabela do CRM)
      • Hard-delete (não permitido para tabelas company)
    • Empresas Relacionadas
      • CRM - Empresas relacionadas
      • Tipos de relacionamento disponíveis
      • Listar relacionamentos de uma empresa (ambas as direções)
      • Criar relacionamento entre duas empresas
      • Alterar o tipo do relacionamento
      • Inativar relacionamento (reversível)
      • Excluir relacionamento (hard-delete)
    • Ticket ↔ Empresa
      • CRM - Ticket <-> Empresa
      • Empresas elegíveis para o ticket
      • Vincular / trocar a empresa do ticket
    • Templates
      • CRM - Templates
      • Listar templates do tenant (apenas IDs, sem fields)
      • Detalhe completo do template (com fields)
      • Pesquisa formatada por scope (CRMSearchResult)
  • Workflow
    • Workflow - Overview
    • Tickets
      • Workflow - Tickets
      • Detalhe completo do ticket (mensagens, SLA, fases, customer, empresa, business)
      • Criar ticket (básico, com integração CRM opcional)
      • Criar ticket com auto-vínculo / criação de customer via contato
      • Movimentar ticket entre fases (ou finalizar)
      • Atualizar dados do ticket (nome, descrição, valor)
      • Vincular cliente CRM a um ticket existente
      • Adicionar nota ou mensagem ao ticket
    • Workspaces & Workflows
      • Workflow - Workspaces & Workflows
      • Listar workspaces e workflows acessíveis ao usuário
      • Listar fases de um workflow
      • Listar tickets de uma ou mais fases (paginado)
  • Webhooks
    • Eventos
      • Catálogo de eventos disponíveis
      • 📨 [Contrato] Evento entregue na sua URL
    • Assinaturas
      • Listar webhooks cadastrados
        GET
      • Criar webhook (o secret aparece UMA única vez)
        POST
      • Testar conectividade de uma URL
        POST
      • Detalhar webhook
        GET
      • Atualizar webhook
        PUT
      • Ativar/desativar webhook (toggle)
        PATCH
      • Remover webhook (soft delete)
        DELETE
    • Entregas
      • Log de entregas de uma assinatura
      • Reprocessar uma entrega
      • Reprocessar TODAS as entregas com falha
  1. Assinaturas

Atualizar webhook

PUT
{{baseURL}}/api/v2/webhooks/subscriptions/{id}
Última modificação:2026-06-11 04:53:01
Atualização parcial — envie apenas os campos que quer alterar
(name, url, events, filters, is_active).
A URL passa pelas mesmas validações do create (HTTPS, IP público).
O secret NÃO muda no update.

Requisição

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/json

Exemplo
{
    "events": [
        "ticket.created",
        "ticket.closed",
        "ticket.phase_changed"
    ]
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request PUT 'https://api-{tenant}.digitalk.com.br/api/v2/webhooks/subscriptions/' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)' \
--header 'Content-Type: application/json' \
--data '{
    "events": [
        "ticket.created",
        "ticket.closed",
        "ticket.phase_changed"
    ]
}'

Respostas

🟢200OK
application/json
Assinatura atualizada (envelope {ok, data}).
Bodyapplication/json

Exemplo
{
    "ok": true,
    "code": 0,
    "data": {
        "id": "string",
        "name": "string",
        "description": "string",
        "url": "string",
        "events": [
            "string"
        ],
        "filters": {},
        "is_active": true,
        "secret_preview": "string",
        "secret": "string",
        "created_by": 0,
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    }
}
Modificado em 2026-06-11 04:53:01
Página anterior
Detalhar webhook
Próxima página
Ativar/desativar webhook (toggle)
Built with