Entrar

Payload del webhook — ejemplo completo

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

Solo referencia — esta página describe la solicitud que Sender envía a la URL que registraste en Crear external provider. Tú no llamas a este endpoint; tú lo implementas.

Autenticación

El header Authorization (o X-API-Key) se arma a partir del data.authMethod/data.authToken guardado en el proveedor:

authMethod Header
bearer Authorization: Bearer {authToken}
basic Authorization: Basic base64(authUsername:authPassword)
apikey X-API-Key: {authToken}
none No se envía header de autenticación

Respuesta esperada

Status HTTP Comportamiento de Sender
2xx Éxito — el mensaje queda como done.
4xx Error permanente — no reintenta.
5xx Error transitorio — reintenta.
Timeout Error transitorio — reintenta.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

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

Encabezados

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.

Cuerpo de la petición

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"
        }
    }
}

Respuestas

{ "received": true }

Relacionados

Copied to clipboard