Developer Network

Documentação

Informações e instruções das APIs dos produtos Locaweb.

Como configurar o webhook

Aprenda a configurar o webhook

Para começar a receber eventos por webhook, configure o seu painel do SMTP Locaweb em https://smtplw.com.br/panel/settings/webhook.


Para garantir o correto funcionamento do serviço e o tratamento seguro do tráfego são suportadas as portas de destino 80 e 443. Recomendamos o uso da porta 443, pois ela é padrão para tráfego seguro de HTTPS.

Detalhes da requisição

Cada evento é notificado com uma requisição do tipo POST para a URL configurada no painel. Entre as suas características estão:

Content-Type

application/x-www-form-urlencoded

Estrutura dos parâmetros

Parâmetro Descrição
bounce_description=[bounce_description] Tipo do erro
bounce_code=[bounce_code] Código do erro
sender=[sender] Remetente
to=[to] Destinatário
subject=[subject] Assunto da mensagem
x-smtplw=[x-smtplw] Cabeçalho da mensagem

Exemplo de requisição

1
2
3
4
POST http://dominio.com/webhook.php
content-type: application/x-www-form-urlencoded

bounce_description=Desconhecido&bounce_code=5.0.0&sender=remetente%40domain.com&to=destinatario%40domain.com&subject=assunto+qualquer&x-smtplw=valor+qualquer+(opcional)

Tipos de eventos

Erros (bounces)

São mensagens que não foram entregues e que, portanto, retornam erros.


Confira aqui a lista detalhada de todos os eventos.

Exemplos de código para recebimento das notificações

PHP
ASP