Certificados da autoridade de certificação (CA) de Webhooks

Use este ponto de extremidade para gerenciar seus certificados se a URL do Webhook definida nas configurações do app usar um certificado interno da autoridade de certificação (CA).

Recuperação

Use este ponto de extremidade para recuperar o certificado da CA de webhook.

Exemplo

Solicitação:

GET /v1/certificates/webhooks/ca

Resposta:

Content-Type: text/plain
Content-Length: content-size

certificate

Se nenhum certificado for encontrado, será retornado um código de resposta 404 sem corpo.

Como carregar

Se a URL do Webhook definida nas configurações do app usar um certificado interno da CA, será necessário carregá-lo na WhatsApp Business API para garantir a compatibilidade. Se você estiver usando um certificado da CA externamente conhecido, poderá ignorar esta seção com segurança.

É possível gerar um certificado autoassinado no formato PEM ao executar:

openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

O arquivo do certificado deve estar no formato PEM. Se você tiver mais de um certificado para carregar, eles devem ser combinados por concatenação em um único arquivo:

cat cert1.pem cert2.pem > bundle.pem

Exemplo

Solicitação:

POST /v1/certificates/webhooks/ca
Content-Type: text/plain
Content-Length: content-size

certificate

Se for necessário enviar o certificado por cURL, ele deverá ter esta aparência:

curl -X POST \
  https://your-webapp-hostname:your-webapp-port/v1/certificates/webhooks/ca \
  -H 'Authorization: Bearer your-auth-token' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: text/plain' \
  --data-binary @your-path-to-certificate.pem \
  -k

Se já existir um certificado, ele será substituído. Para as alterações entrarem em vigor, todos os nós do Coreapp precisam ser reiniciados após o carregamento do certificado.

A resposta será semelhante a esta:

null or {}

Exclusão

Faça uma solicitação DELETE para este ponto de extremidade se quiser excluir o certificado da CA.

Exemplo

Solicitação:

DELETE /v1/certificates/webhooks/ca

Resposta:

null or {}