Envio de Mensagem

Método sendmessage:

require 'Src/ZapMEApi.php';

$zapme              = new ZapMEApi;
$zapme->api         = 'api-7815696ecbf1c96e6894b';
$zapme->secret      = '0876943851';
$zapme->method      = 'sendmessage';
$zapme->phone       = '5599999999999';
$zapme->message     = 'Olá, teste!';

/**
* Usando o parametro: $zapme->document em conjunto com o método `sendmessage` você pode
* enviar uma imagem ou pdf através da API. Entretanto a imagem/pdf deve possuir até 2mb e deve
* ser uma imagem/pdf já em hash base64 convertida por função PHP ou em sites que façam isso.
*
* Exemplo:
* $zapme->document = 'iVBORw0KGgoAAAANSUhEUgAAARwAAAEiCAYAAAArhG09AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAODSURBVHhe7dQxEQAwCACx+nfMMVAXP2WIhbyZPYCCcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcICMcIDI3gfjoAeT7EafpgAAAABJRU5ErkJggg==';
* $zapme->filetype = 'jpg'; #jpg = para imagem; pdf = para pdf
*/

$return = $zapme->Run();

if($return['result'] === 'success' && $return['status_result'] === 'message_queued')
{
        echo 'Mensagem enviada!';
}
else
{
        echo $return['message'];
}

Retorno da Variavel $return:

{
        "result": "success",
        "date": "2020-03-15 11:56:09",
        "status": 200,
        "messageid": 24,
        "status_result": "message_queued",
        "message": "mensagem enviada com sucesso"
}

Explicação dos Parâmetros

  • api

sua API obtida na ZapMe

  • secret

sua chave secreta obtida na ZapMe

  • method

o método utilizado, neste caso: sendmessage

  • phone

o telefone destinatário

  • message

o texto da mensagem

  • document

hash base64 de um documento a ser anexado ao envio

  • filetype

tipo do documento anexado (jpg ou pdf)

Importante

Os parametros document e filetype só devem ser preenchidos caso você tenha interesse em enviar um anexo (jpg ou pdf) ao envio. Caso contrário, ignore-os. Se você pretende enviar um anexo, o document deve ser a hash base64 do documento.

Anexando Documento ao Envio

Você pode anexar documento do tipo jpg ou pdf ao envio. Para isso é necessário que você extraia a hash base64 do documento e anexe-a ao parametro document em conjunto com o parâmetro filetype, onde este deve receber jpg, se você estiver enviando uma imagem ou pdf, se você estiver enviando um arquivo pdf.

Você pode extrair a hash base64 do documento usando a função do PHP, veja exemplo:

// 1. aponte o arquivo para uma variável temporária
$arquivo            = 'caminho/até/o/arquivo.jpg';

// 2. extraímos a hash com a função do php
$hash               = base64_encode($arquivo);

// 3. passamos a hash para o parâmetro da API
$zapme->document    = $hash;

// 4. definimos o filetype como 'jpg' (porque é uma imagem)
$zapme->filetype    = 'jpg';

// 5. emitimos o envio da requisição
$return             = $zapme->Run();

Ou você pode extrair a hash base64 em um site online como o https://base64.guru