Envio de Mensagem

Método sendmessage:

<?php

require __DIR__ . '/vendor/autoload.php';

use ZapMeTeam\Api\ZapMeApi;

$zapme = (new ZapMeApi)
        ->setApi('API')
        ->setSecret('CHAVE_SECRETA');

$numeros = '5511985850505';

// utilizando o método sendMessage
$zapme->sendMessage($numeros, 'Testando o SDK da ZapMe')->getResult();

Exemplo de retorno deste método:

{
        "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 Obrigatórios da Requisição

  • API

sua API obtida na ZapMe

  • CHAVE_SECRETA

sua chave secreta obtida na ZapMe

  • sendMessage e os seus parâmetros

o método do SDK a ser utilizado nesta ação, neste caso: sendmessage

Anexando Imagem/PDF ao Envio

Para anexar um arquivo para envio você deve apenas extrair a hash base64 deste arquivo e em seguida anexa-la ao array de dados do terceiro parâmetro da função $zapme->sendMessage();

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 como um array no terceiro argumento da função:
$zapme->sendMessage($numeros, 'Testando o SDK da ZapMe', [
                'document' => $hash,
                'filetype' => 'jpg'  //ou pdf se o arquivo for um pdf
        ])->getResult();

Você também pode extrair a hash base64 de um arquivo em um site online como o https://base64.guru

Configurações de Anexo de Arquivos

  • Formatos Arquivos Aceitos:

jpg ou pdf

  • Tamanho Máximo (dimensão):

720x720 (aplica-se somente em imagens)

  • Tamanho Máximo (peso):

2mb

Envio de Multiplas Mensagens

Ao transformar a variável $numeros em um array, a mesma mensagem será encaminhada para todos os números do array, por exemplo:

<?php

require __DIR__ . '/vendor/autoload.php';

use ZapMeTeam\Api\ZapMeApi;

$zapme = (new ZapMeApi)
        ->setApi('API')
        ->setSecret('CHAVE_SECRETA');

$numeros = [
        '5511985850808',
        '5579985774212',
        '5521978780101',
];

$zapme->sendMessage($numeros, 'Testando o SDK da ZapMe')->getResult();

Aviso

Para fazer este tipo de envio, atente-se a analise as configurações do PHP do seu ambiente (max_execution_time e max_input_time), porque a depender da quantidade de números no array o servidor poderá “travar” ao alcançar os valores configurados.