Entrar

Payload do webhook — exemplo completo

POST https://{organization}.myguper.comhttps://your-server.example.com/your-webhook

Apenas referência — esta página descreve a requisição que o Sender envia para a URL que você cadastrou em Criar external provider. Você não chama esse endpoint; você implementa.

Autenticação

O header Authorization (ou X-API-Key) é montado a partir do data.authMethod/data.authToken salvo no provider:

authMethod Header
bearer Authorization: Bearer {authToken}
basic Authorization: Basic base64(authUsername:authPassword)
apikey X-API-Key: {authToken}
none Nenhum header de autenticação é enviado

Resposta esperada

Status HTTP Comportamento do Sender
2xx Sucesso — mensagem marcada como done.
4xx Erro permanente — não retenta.
5xx Erro transitório — retenta.
Timeout Erro transitório — retenta.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

Send your user token in the x-guper-authorization header.

Cabeçalhos

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json`.
Authorization string Set when `data.authMethod` is `bearer` or `basic`. See the table above.
X-API-Key string Set when `data.authMethod` is `apikey`.
User-Agent * string Identifies the Sender service making the call.

Corpo da requisição

Content-Type: application/json

{
    "event": "message.send",
    "timestamp": "2026-02-26T14:30:00Z",
    "organization": "xpto",
    "message": {
        "id": "12345",
        "sequence": "welcome",
        "slug": "welcome_email",
        "subject": "Olá Joao, bem-vindo!",
        "body": "Seu cadastro foi confirmado. Aproveite seu cashback de R$ 50,00.",
        "destination": {
            "name": "Joao Silva",
            "email": "joao@email.com",
            "cellphone": "+5511999999999",
            "countryCallingCode": "55"
        }
    },
    "variables": {
        "client": {
            "name": "Joao Silva",
            "email": "joao@email.com",
            "cellphone": "11999999999"
        },
        "order": {
            "id": 123,
            "total": 5000,
            "date": "2026-02-26 14:30:00"
        },
        "reward": {
            "name": "Cashback",
            "value": 5000
        },
        "organization": {
            "name": "Loja XYZ",
            "currency": "BRL",
            "language": "pt_BR"
        }
    }
}

Respostas

{ "received": true }

Relacionados

Copied to clipboard