Testar conectividade de uma URL

POST

{{baseURL}}/api/v2/webhooks/subscriptions/test

Última modificação:2026-06-11 04:53:01

Dispara um POST de teste (event_type: webhook.test) na URL informada e
retorna o resultado — útil pra validar o receptor ANTES de criar a assinatura.

O corpo enviado segue o envelope padrão, mas sem assinatura HMAC
(não há secret ainda). reachable: true = sua URL respondeu 2xx em até 10s.

Mesmas validações de URL do create (HTTPS, IP público).

Requisição

Parâmetros Header

Parâmetros Bodyapplication/json

Exemplo

{
    "url": "https://erp.suaempresa.com.br/digitalk/webhook"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api-{tenant}.digitalk.com.br/api/v2/webhooks/subscriptions/test' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://erp.suaempresa.com.br/digitalk/webhook"
}'

Respostas

🟢200OK

application/json

Resultado do teste de conectividade.

Bodyapplication/json

Examples

URL OKURL não respondeu em 10s

{
    "ok": true,
    "code": 200,
    "data": {
        "reachable": true,
        "response_status": 200,
        "response_body": "{\"received\":true}"
    }
}

Modificado em 2026-06-11 04:53:01

Página anterior

Criar webhook (o secret aparece UMA única vez)

Próxima página

Detalhar webhook